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

Den här cmdleten är endast tillgänglig på Windows-plattformen.

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:\> 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. Connect-WSMan Ansluter sedan till fjärrserver01-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
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
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:Microsoft.WSMan.Management.ProxyAccessType
Accepted values:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAuthentication

Anger vilken autentiseringsmetod som ska användas vid proxyn. De acceptabla värdena för den här parametern är:

  • Basic – Basic är ett schema där användarnamnet och lösenordet skickas i klartext till servern eller proxyn.
  • Digest – Sammanfattning är ett utmaningssvarsschema som använder en server angiven datasträng för utmaningen.
  • Negotiate – Förhandla ä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:Microsoft.WSMan.Management.ProxyAuthentication
Accepted values:Negotiate, Basic, Digest
Position:Named
Default value:None
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
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
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
Accept pipeline input:False
Accept wildcard characters:False

-SkipRevocationCheck

Anger att anslutningen inte verifierar återkallningsstatusen på servercertifikatet.

Type:SwitchParameter
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False

Utdata

SessionOption