Delen via

New-WSManSessionOption

  • Referentie
Module:
Microsoft.WSMan.Management

Hiermee maakt u een hashtabel voor sessieopties voor gebruik als invoerparameters voor WS-Management-cmdlets.

Syntaxis

New-WSManSessionOption
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <ProxyAuthentication>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-SPNPort <Int32>]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [<CommonParameters>]

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De New-WSManSessionOption cmdlet maakt een hash-tabel met WSMan-sessieopties die kan worden doorgegeven aan WSMan-cmdlets:

  • Get-WSManInstance
  • Set-WSManInstance
  • Invoke-WSManAction
  • Connect-WSMan

Voorbeelden

Voorbeeld 1: Een verbinding maken die gebruikmaakt van verbindingsopties

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

In dit voorbeeld wordt een verbinding met de externe server01-computer gemaakt met behulp van de verbindingsopties die zijn gedefinieerd door New-WSManSessionOption.

De eerste opdracht gebruikt New-WSManSessionOption voor het opslaan van een set verbindingsinstellingsopties in de $a variabele. In dit geval stellen de sessieopties een verbindingstime in van 30 seconden (30.000 milliseconden).

De tweede opdracht maakt gebruik van de parameter SessionOption om de referenties door te geven die in de $a variabele Connect-WSManzijn opgeslagen. Connect-WSMan Maak vervolgens verbinding met de externe server01-computer met behulp van de opgegeven sessieopties.

Connect-WSMan wordt doorgaans gebruikt in de context van de WSMan-provider om verbinding te maken met een externe computer, in dit geval de server01-computer. U kunt de cmdlet echter gebruiken om verbindingen met externe computers tot stand te brengen voordat u overgaat naar de WSMan-provider. Deze verbindingen worden weergegeven in de lijst ComputerName .

Parameters

-NoEncryption

Geeft aan dat de verbinding geen versleuteling gebruikt voor externe bewerkingen via HTTP.

Niet-versleuteld verkeer is standaard niet ingeschakeld. Deze moet zijn ingeschakeld in de lokale configuratie.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OperationTimeout

Hiermee geeft u de time-out, in milliseconden, voor de WS-Management-bewerking.

Type:Int32
Aliassen:OperationTimeoutMSec
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProxyAccessType

Hiermee geeft u het mechanisme op waarmee de proxyserver zich bevindt. De aanvaardbare waarden voor deze parameter zijn:

  • ProxyIEConfig - Gebruik de proxyconfiguratie van Internet Explorer voor de huidige gebruiker.
  • ProxyWinHttpConfig - De WSMan-client maakt gebruik van de proxy-instellingen die zijn geconfigureerd voor WinHTTP, met behulp van het hulpprogramma ProxyCfg.exe.
  • ProxyAutoDetect - Automatische detectie van een proxyserver afdwingen.
  • ProxyNoProxyServer - Gebruik geen proxyserver. Los alle hostnamen lokaal op.

De standaardwaarde is ProxyIEConfig.

Type:ProxyAccessType
Geaccepteerde waarden:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProxyAuthentication

Hiermee geeft u de verificatiemethode op die moet worden gebruikt bij de proxy. De aanvaardbare waarden voor deze parameter zijn:

  • Basic - Basic is een schema waarin de gebruikersnaam en het wachtwoord in duidelijke tekst naar de server of proxy worden verzonden.
  • Digest - Digest is een challenge-response-schema dat gebruikmaakt van een door de server opgegeven gegevensreeks voor de uitdaging.
  • Negotiate - Onderhandelen is een challenge-response-schema dat onderhandelt met de server of proxy om te bepalen welk schema moet worden gebruikt voor verificatie. Voorbeelden zijn het Kerberos-protocol en NTLM.

De standaardwaarde is Onderhandelen.

Type:ProxyAuthentication
Geaccepteerde waarden:Negotiate, Basic, Digest
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProxyCredential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om toegang te krijgen via een tussenliggende webproxy.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipCACheck

Hiermee geeft u op dat wanneer er verbinding wordt gemaakt via HTTPS, de client niet valideert dat het servercertificaat is ondertekend door een vertrouwde certificeringsinstantie (CA). Gebruik deze optie alleen als de externe computer wordt vertrouwd door een andere methode, bijvoorbeeld als de externe computer deel uitmaakt van een netwerk dat fysiek veilig en geïsoleerd is of de externe computer wordt vermeld als een vertrouwde host in de WS-Management-configuratie.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipCNCheck

Hiermee geeft u op dat de algemene naam van het certificaat (CN) van de server niet moet overeenkomen met de hostnaam van de server. Dit wordt alleen gebruikt in externe bewerkingen via HTTPS. Deze optie mag alleen worden gebruikt voor vertrouwde computers.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipRevocationCheck

Geeft aan dat de verbinding de intrekkingsstatus op het servercertificaat niet valideert.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SPNPort

Hiermee geeft u een poortnummer op dat moet worden toegevoegd aan de SPN (Connection Service Principal Name) van de externe server. Een SPN wordt gebruikt wanneer het verificatiemechanisme Kerberos of Negotiate is.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UseUTF16

Geeft aan dat de verbinding de aanvraag in UTF16-indeling codeert in plaats van UTF8-indeling. De standaardwaarde is UTF8-codering.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

SessionOption

Met deze cmdlet wordt de gemaakte WSMan-sessieoptie geretourneerd als een SessionOption-object .