PowerShell/docs/KNOWNISSUES.md
2016-05-19 15:23:00 -07:00

93 lines
2.8 KiB
Markdown

# Known Issues
## SecureString
The `SecureString` class is *not* the well-known C# `SecureString`, as the
library is not available in .NET Core. However, PowerShell continues to use the
type for two main reasons: FullCLR compatibility, and as a specially-treated
type (that is, behavior is dependent on the type being `SecureString`). Instead,
the `SecureString` is Mono's completely not secure whatsoever, but open-source
and "compatible" stub that acts just like a plaintext `StringBuilder`. **It has
no encryption.**
Additionally `ReadLineSafe` is not implemented, meaning `Get-Credential` fails
with `PlatformNotSupportedException`.
## `ControlPanelItemCommand.cs`
The file `monad/src/commands/management/ControlPanelItemCommand.cs` has been removed
temporarily from `Microsoft.PowerShell.Commands.Management` because we
cannot resolve `[Shell32.ShellFolderItem]` for FullCLR builds. This must be
fixed ASAP.
## `GetComputerInfoCommand.cs`
The file
`src\Microsoft.PowerShell.Commands.Management\commands\management\GetComputerInfoCommand.cs`
is not currently compiled because it needs resources.
## Jobs
The PowerShell jobs fail, see [#1010][].
[#1010]: https://github.com/PowerShell/PowerShell/issues/1010
## xUnit
The xUnit tests can only be run on Linux.
## Console Output
Performance issues have been seen in some scenarios, such as nested SSH
sessions. We believe this is likely an issue with `Console.ReadKey()` and are
investigating.
## Non-interactive console bugs
The `ConsoleHost` is buggy when running under an environment without a proper
TTY. This is due to exceptions thrown in the `RawUI` class from `System.Console`
that are silenced in the formatting subsystem. See issue [#984][].
[#984]: https://github.com/PowerShell/PowerShell/issues/984
## Sessions
PowerShell sessions do not work because of remoting requirements, so
`New-PSSession` etc. crash.
## Aliases
The aliases that conflict with native Linux / OS X commands are removed. This is
an open discussion in issue [#929][]. See commit 7d9f43966 for their removal,
and 3582bb421 for the merge.
[#929]: https://github.com/PowerShell/PowerShell/issues/929
## Unavailable cmdlets
This project includes the CoreCLR versions of the `Commands.Management`,
`Commands.Utility`, `Security`, and `PSDiagnostics` modules.
The `Archive`, `Diagnostics`, `PSGet`, and `Host` modules are not yet included.
The `WSMan.Management` module cannot be included unless the
`Management.Infrastructure.Native` library is ported.
The CoreCLR version of the `Commands.Utility` module does not contain the
following cmdlets that exist in the FullCLR version:
- ConvertFrom-String
- ConvertTo-Html
- Export-PSSession
- Get-TraceSource
- Import-PSSession
- Invoke-RestMethod
- Invoke-WebRequest
- Out-GridView
- Out-Printer
- Send-MailMessage
- Set-TraceSource
- Show-Command
- Trace-Command
- Update-List