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

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

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

Przykłady

Przykład 1. Tworzenie połączenia korzystającego 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-WSManSessionOption.

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

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

Connect-WSMan jest zwykle używany w kontekście dostawcy WSMan do nawiązywania połączenia 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 programu 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. Musi być włączona w konfiguracji lokalnej.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OperationTimeout

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

Typ:Int32
Aliasy:OperationTimeoutMSec
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProxyAccessType

Określa mechanizm, za pomocą którego znajduje się serwer proxy. Dopuszczalne wartości 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 środowiska 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.

Typ:ProxyAccessType
Dopuszczalne wartości:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProxyAuthentication

Określa metodę uwierzytelniania, która ma być używana na serwerze proxy. Dopuszczalne wartości tego parametru to:

  • Basic — podstawowy 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 — Negocjacja to schemat odpowiedzi na żądanie, który negocjuje z serwerem lub serwerem proxy w celu określenia schematu używanego do uwierzytelniania. Przykłady to protokół Kerberos i NTLM.

Wartość domyślna to Negotiate.

Typ:ProxyAuthentication
Dopuszczalne wartości:Negotiate, Basic, Digest
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProxyCredential

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

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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). Użyj tej opcji 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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 dla zaufanych komputerów.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SkipRevocationCheck

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UseUTF16

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

SessionOption

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