Udostępnij przez

New-WSManSessionOption

Moduł:
Microsoft.WSMan.Management Module

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

Składnia

Default (Domyślna) 

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.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-OperationTimeout

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

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:OperationTimeoutMSec

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:ProxyAccessType
Domyślna wartość:None
Dopuszczalne wartości:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:ProxyAuthentication
Domyślna wartość:None
Dopuszczalne wartości:Negotiate, Basic, Digest
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ProxyCredential

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

Właściwości parametru

Typ:PSCredential
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SkipRevocationCheck

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

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-UseUTF16

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

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wyjściowe

SessionOption

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