CmdID / PowerShell / Cmdlets / New
New-WSManSessionOption
Creates session option hash table to use as input parameters for WS-Management cmdlets. PowerShell reference
From the PowerShell reference 10 parameters
What it does
Creates session option hash table to use as input parameters for WS-Management cmdlets. The New-WSManSessionOption cmdlet creates a WSMan Session option hash table which can be passed to WSMan cmdlets: - Get-WSManInstance - Set-WSManInstance - Invoke-WSManAction - Connect-WSMan
New-WSManSessionOption [-ProxyAccessType <ProxyAccessType>] [-ProxyAuthentication <ProxyAuthentication>] [-ProxyCredential <PSCredential>] [-SkipCACheck] [-SkipCNCheck] [-SkipRevocationCheck] [-SPNPort <Int32>] [-OperationTimeout <Int32>] [-NoEncryption] [-UseUTF16] [<CommonParameters>]Create a connection that uses connection options
PS C:> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:> cd WSMan:
PS WSMan:> dirIdentifyIts page in the reference: New-WSManSessionOption.
Parameters
-NoEncryptionIndicates that the connection does not use encryption for remote operations over HTTP.
By default, unencrypted traffic is not enabled. It must be enabled in the local configuration.-OperationTimeoutSpecifies the time-out, in milliseconds, for the WS-Management operation.-ProxyAccessTypeSpecifies the mechanism by which the proxy server is located. The acceptable values for this parameter are:
- ProxyIEConfig - Use the Internet Explorer proxy configuration for the current user.
- ProxyWinHttpConfig - The WSMan client uses the proxy settings configured for WinHTTP, using the
ProxyCfg.exe utility.
- ProxyAutoDetect - Force auto-detection of a proxy server.
- ProxyNoProxyServer - Do not use a proxy server. Resolve all host names locally.
The default value is ProxyIEConfig.-ProxyAuthenticationSpecifies the authentication method to use at the proxy. The acceptable values for this parameter are:
- Basic - Basic is a scheme in which the user name and password are sent in clear-text to the
server or proxy.
- Digest - Digest is a challenge-response scheme that uses a server-specified data string for the
challenge.
- Negotiate - Negotiate is a challenge-response scheme that negotiates with the server or proxy to
determine which scheme to use for authentication. Examples are the Kerberos protocol and NTLM.
The default value is Negotiate.-ProxyCredentialSpecifies a user account that has permission to gain access through an intermediate Web proxy.-SkipCACheckSpecifies that, when it connects over HTTPS, the client does not validate that the server certificate is signed by a trusted certification authority (CA). Use this option only when the remote computer is trusted by another method, for example, if the remote computer is part of a network that is physically secure and isolated or the remote computer is listed as a trusted host in the WS-Management configuration.-SkipCNCheckSpecifies that the certificate common name (CN) of the server does not have to match the host name of the server. This is used only in remote operations using HTTPS. This option should only be used for trusted computers.-SkipRevocationCheckIndicates that the connection does not validate the revocation status on the server certificate.-SPNPortSpecifies a port number to append to the connection Service Principal Name (SPN) of the remote server. An SPN is used when the authentication mechanism is Kerberos or Negotiate.-UseUTF16Indicates that the connection encodes the request in UTF16 format instead of UTF8 format. The default is UTF8 encoding.