powershellscripts.com

Tutorials  PowerShell Cmdlet Help for New-WSManSessionOption



NAME
New-WSManSessionOption

SYNOPSIS
Creates a WS-Management session option hash table to use as input parameters to the following WS-Management cmdlets
:
Get-WSManInstance
Set-WSManInstance
Invoke-WSManAction
Connect-WSMan

SYNTAX
New-WSManSessionOption [-NoCompression ] [-NoProxy ] [-ProxyAuthentication ] [-ProxyPasswor
d ] [-ProxyUserName ] [-SkipCACheck ] [-SkipCNCheck ] [-SkipRevocation ] [-
SPNPort ] [-Timeout ] [-UnEncrypted ] [-UseIEProxyconfig ] [-UseProxyAutoDetection h>] [-UseWinHTTPProxyConfig ] [-UTF16 ] []


DESCRIPTION
Creates a WSMan Session option hashtable which can be passed into WSMan cmdlets:
Get-WSManInstance
Set-WSManInstance
Invoke-WSManAction
Connect-WSMan


PARAMETERS
-NoCompression
Turns off packet compression in the session. Compression is enabled by default and the packets sent between the
client and server are compressed. Compression uses more processor cycles, but it makes transmission faster.

Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false

-NoProxy
Do not use a proxy server. All all host names will be resolved locally.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-ProxyAuthentication
Specifies the authentication method to use at the proxy. Possible values 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 (the default): 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.

Required? false
Position? named
Default value Negotiate
Accept pipeline input? false
Accept wildcard characters? false

-ProxyPassword
Specifies a password to to be used for proxy authentication.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-ProxyUserName
Specifies a user name to to be used for proxy authentication.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-SkipCACheck
Specifies that when connecting over HTTPS, the client does not validate that the server certificate is signed b
y a trusted certificate authority (CA). Use this option only when the remote computer is trusted by other means
, 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.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-SkipCNCheck
Specifies that the certificate common name (CN) of the server does not need to match the hostname of the server
. This is used only in remote operations using HTTPS. This option should only be used for trusted computers.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-SkipRevocation
Do not validate the revocation status on the server certificate.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-SPNPort
Specifies a port number to append to the connection Service Principal Name of the remote server. An SPN
is used when the authentication mechanism is Kerberos or Negotiate.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Timeout
Defines the timeout in milliseconds for the WS-Management operation.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-UnEncrypted
Do not use encryption when doing remote operations over HTTP.

Note: Unencrypted traffic is not allowed by default and must be enabled in the local configuration.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-UseIEProxyconfig
Use the Internet Explorer proxy configuration for the current user. This is the default setting.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-UseProxyAutoDetection
Force auto-detection of a proxy.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-UseWinHTTPProxyConfig
Use the proxy settings configured for WinHTTP.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-UTF16
Encode the request in UTF16 format rather than UTF8 format. The default is UTF8 encoding.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS




OUTPUTS
SessionOption



NOTES






RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkId=141449
Connect-WSMan
Disable-WSManCredSSP
Disconnect-WSMan
Enable-WSManCredSSP
Get-WSManCredSSP
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
Remove-WSManInstance
Set-WSManInstance
Set-WSManQuickConfig
Test-WSMan