New-WSManSessionOption
Tworzy tabelę skrótów opcji sesji do użycia jako parametry wejściowe dla poleceń cmdlet WS-Management.
Składnia
New-WSManSessionOption
[-ProxyAccessType <ProxyAccessType>]
[-ProxyAuthentication <ProxyAuthentication>]
[-ProxyCredential <PSCredential>]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-SPNPort <Int32>]
[-OperationTimeout <Int32>]
[-NoEncryption]
[-UseUTF16]
[<CommonParameters>]
Opis
Polecenie New-WSManSessionOption
cmdlet 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
program .
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 poza 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 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.
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 tego parametru to:
ProxyIEConfig
— Użyj konfiguracji serwera proxy programu Internet Explorer dla bieżącego użytkownika.ProxyWinHttpConfig
— Klient WSMan używa ustawień serwera proxy skonfigurowanych dla 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, 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, 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). 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.
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 dla 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
To polecenie cmdlet zwraca utworzoną opcję sesji WSMan jako obiekt SessionOption .
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla