New-WSManSessionOption
Skapar en hash-tabell för sessionsalternativ som ska användas som indataparametrar för WS-Management cmdletar.
Syntax
New-WSManSessionOption
[-ProxyAccessType <ProxyAccessType>]
[-ProxyAuthentication <ProxyAuthentication>]
[-ProxyCredential <PSCredential>]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-SPNPort <Int32>]
[-OperationTimeout <Int32>]
[-NoEncryption]
[-UseUTF16]
[<CommonParameters>]
Description
Cmdleten New-WSManSessionOption skapar en hashtabell för WSMan-sessionsalternativet som kan skickas till WSMan-cmdletar:
- Get-WSManInstance
- Set-WSManInstance
- Invoke-WSManAction
- Connect-WSMan
Exempel
Exempel 1: Skapa en anslutning som använder anslutningsalternativ
PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS WSMan:\>
PS WSMan:\> dir
WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName Type
------------ ----
localhost Container
server01 Container
Det här exemplet skapar en anslutning till fjärrserver01-datorn med hjälp av de anslutningsalternativ som definieras av New-WSManSessionOption.
Det första kommandot använder New-WSManSessionOption för att lagra en uppsättning alternativ för anslutningsinställningar i variabeln $a. I det här fallet anger sessionsalternativen en anslutningstid på 30 sekunder (30 000 millisekunder).
Det andra kommandot använder parametern SessionOption för att skicka autentiseringsuppgifterna som lagras i variabeln $a till Connect-WSMan. Sedan ansluter Connect-WSMan till fjärrservern01-datorn med hjälp av de angivna sessionsalternativen.
Connect-WSMan används vanligtvis i kontexten för WSMan-providern för att ansluta till en fjärrdator, i det här fallet server01-datorn. Du kan dock använda cmdleten för att upprätta anslutningar till fjärrdatorer innan du byter till WSMan-providern. Dessa anslutningar visas i listan ComputerName .
Parametrar
-NoEncryption
Anger att anslutningen inte använder kryptering för fjärråtgärder via HTTP.
Okrypterad trafik är som standard inte aktiverat. Den måste vara aktiverad i den lokala konfigurationen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OperationTimeout
Anger tidsgränsen i millisekunder för den WS-Management åtgärden.
Type: | Int32 |
Aliases: | OperationTimeoutMSec |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyAccessType
Anger den mekanism som proxyservern finns med. De acceptabla värdena för den här parametern är:
- ProxyIEConfig. Använd Internet Explorer-proxykonfigurationen för den aktuella användaren.
- ProxyWinHttpConfig. WSMan-klienten använder proxyinställningarna som konfigurerats för WinHTTP med hjälp av verktyget ProxyCfg.exe.
- ProxyAutoDetect. Framtvinga automatisk identifiering av en proxyserver.
- ProxyNoProxyServer. Använd inte en proxyserver. Lös alla värdnamn lokalt.
Standardvärdet är ProxyIEConfig.
Type: | ProxyAccessType |
Accepted values: | ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyAuthentication
Anger den autentiseringsmetod som ska användas vid proxyn. De acceptabla värdena för den här parametern är:
- Grundläggande. Basic är ett schema där användarnamn och lösenord skickas i klartext till servern eller proxyn.
- Digest. Sammanfattning är ett utmaningssvarsschema som använder en server angiven datasträng för utmaningen.
- Förhandla. Negotiate är ett utmaningssvarsschema som förhandlar med servern eller proxyn för att avgöra vilket schema som ska användas för autentisering. Exempel är Kerberos-protokollet och NTLM.
Standardvärdet är Negotiate.
Type: | ProxyAuthentication |
Accepted values: | Negotiate, Basic, Digest |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyCredential
Anger ett användarkonto som har behörighet att få åtkomst via en mellanliggande webbproxy.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipCACheck
Anger att när den ansluter via HTTPS verifierar klienten inte att servercertifikatet har signerats av en betrodd certifikatutfärdare (CA). Använd det här alternativet endast när fjärrdatorn är betrodd av en annan metod, till exempel om fjärrdatorn är en del av ett nätverk som är fysiskt säkert och isolerat eller fjärrdatorn anges som en betrodd värd i WS-Management konfigurationen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipCNCheck
Anger att serverns eget certifikatnamn (CN) inte behöver matcha serverns värdnamn. Detta används endast i fjärråtgärder med HTTPS. Det här alternativet bör endast användas för betrodda datorer.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipRevocationCheck
Anger att anslutningen inte verifierar återkallningsstatusen på servercertifikatet.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SPNPort
Anger ett portnummer som ska läggas till i anslutningstjänstens huvudnamn (SPN) för fjärrservern. Ett SPN används när autentiseringsmekanismen är Kerberos eller Negotiate.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUTF16
Anger att anslutningen kodar begäran i UTF16-format i stället för UTF8-format. Standardinställningen är UTF8-kodning.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Utdata
SessionOption