Udostępnij za pośrednictwem

New-WSManSessionOption

  • Odwołanie
Moduł:
Microsoft.WSMan.Management

Tworzy tabelę skrótów opcji sesji do użycia jako parametry wejściowe dla WS-Management poleceń cmdlet.

Składnia

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

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie New-WSManSessionOption cmdlet tworzy tabelę skrótów opcji WSMan Session, którą można przekazać do poleceń cmdlet programu WSMan:

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

Przykłady

Przykład 1: Twórca połączenie korzystające z opcji połączenia

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

W tym przykładzie jest tworzone połączenie z komputerem zdalnym server01 przy użyciu opcji połączenia zdefiniowanych przez New-WSManSessionOptionprogram .

Pierwsze polecenie używa New-WSManSessionOption polecenia do przechowywania zestawu opcji ustawień połączenia w zmiennej $a . W takim przypadku opcje sesji ustawiają czas połączenia na 30 sekund (30 000 milisekund).

Drugie polecenie używa parametru SessionOption do przekazania poświadczeń przechowywanych w zmiennej $a do Connect-WSMan. Connect-WSMan Następnie łączy się z komputerem zdalnym server01 przy użyciu określonych opcji sesji.

Connect-WSMan jest zwykle używany w kontekście dostawcy WSMan do łączenia się z komputerem zdalnym, w tym przypadku komputera server01. Można jednak użyć polecenia cmdlet , aby nawiązać połączenia z komputerami zdalnymi przed zmianą dostawcy WSMan. Te połączenia są wyświetlane na liście ComputerName .

Parametry

-NoEncryption

Wskazuje, że połączenie nie używa szyfrowania dla operacji zdalnych za pośrednictwem protokołu HTTP.

Domyślnie niezaszyfrowany ruch nie jest włączony. Należy ją włączyć w konfiguracji lokalnej.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OperationTimeout

Określa limit czasu (w milisekundach) dla operacji WS-Management.

Type:Int32
Aliases:OperationTimeoutMSec
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAccessType

Określa mechanizm, za pomocą którego znajduje się serwer proxy. Dopuszczalne wartości dla tego parametru to:

  • ProxyIEConfig — Użyj konfiguracji serwera proxy programu Internet Explorer dla bieżącego użytkownika.
  • ProxyWinHttpConfig — Klient programu WSMan używa ustawień serwera proxy skonfigurowanych dla protokołu WinHTTP przy użyciu narzędzia ProxyCfg.exe.
  • ProxyAutoDetect — Wymusza automatyczne wykrywanie serwera proxy.
  • ProxyNoProxyServer - Nie używaj serwera proxy. Rozpoznawanie wszystkich nazw hostów lokalnie.

Wartość domyślna to 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

Określa metodę uwierzytelniania do użycia na serwerze proxy. Dopuszczalne wartości dla tego parametru to:

  • Basic - Podstawowa to schemat, w którym nazwa użytkownika i hasło są wysyłane w postaci zwykłego tekstu do serwera lub serwera proxy.
  • Digest — Skrót to schemat odpowiedzi wyzwania, który używa ciągu danych określonego przez serwer do wyzwania.
  • Negotiate - Negotiate to schemat odpowiedzi wyzwania, który negocjuje z serwerem lub serwerem proxy, aby określić, który schemat ma być używany do uwierzytelniania. Przykłady są protokołu Kerberos i NTLM.

Wartość domyślna to Negotiate.

Type:ProxyAuthentication
Accepted values:Negotiate, Basic, Digest
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyCredential

Określa konto użytkownika, które ma uprawnienia do uzyskiwania dostępu za pośrednictwem pośredniego serwera proxy sieci Web.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipCACheck

Określa, że po nawiązaniu połączenia za pośrednictwem protokołu HTTPS klient nie weryfikuje, czy certyfikat serwera jest podpisany przez zaufany urząd certyfikacji (CA). Tej opcji należy używać tylko wtedy, gdy komputer zdalny jest zaufany przez inną metodę, na przykład jeśli komputer zdalny jest częścią sieci, która jest fizycznie bezpieczna i izolowana lub komputer zdalny jest wymieniony jako zaufany host w konfiguracji WS-Management.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipCNCheck

Określa, że nazwa pospolita certyfikatu (CN) serwera nie musi być zgodna z nazwą hosta serwera. Jest to używane tylko w operacjach zdalnych przy użyciu protokołu HTTPS. Ta opcja powinna być używana tylko w przypadku zaufanych komputerów.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipRevocationCheck

Wskazuje, że połączenie nie weryfikuje stanu odwołania w certyfikacie serwera.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SPNPort

Określa numer portu, który ma być dołączany do głównej nazwy usługi połączenia (SPN) serwera zdalnego. Nazwa SPN jest używana, gdy mechanizm uwierzytelniania to Kerberos lub Negotiate.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseUTF16

Wskazuje, że połączenie koduje żądanie w formacie UTF16 zamiast formatu UTF8. Wartość domyślna to kodowanie UTF8.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wyjściowe

SessionOption

To polecenie cmdlet zwraca utworzoną opcję sesji WSMan jako obiekt SessionOption .