Test-WSMan
Sprawdza, czy usługa WinRM jest uruchomiona na komputerze lokalnym, czy zdalnym.
Składnia
Test-WSMan
[[-ComputerName] <String>]
[-Authentication <AuthenticationMechanism>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-Credential <PSCredential>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Opis
To polecenie cmdlet jest dostępne tylko na platformie Windows.
Polecenie Test-WSMan
cmdlet przesyła żądanie identyfikacji, które określa, czy usługa WinRM jest uruchomiona na komputerze lokalnym lub zdalnym. Jeśli testowany komputer jest uruchomiony w usłudze, polecenie cmdlet wyświetla schemat tożsamości WS-Management, wersję protokołu, dostawcę produktu i wersję produktu testowanej usługi.
Przykłady
Przykład 1. Określanie stanu usługi WinRM
Test-WSMan
To polecenie określa, czy usługa WinRM jest uruchomiona na komputerze lokalnym, czy na komputerze zdalnym.
Przykład 2. Określanie stanu usługi WinRM na komputerze zdalnym
Test-WSMan -ComputerName "server01"
To polecenie określa, czy usługa WinRM jest uruchomiona na komputerze server01.
Przykład 3. Określanie stanu usługi WinRM i wersji systemu operacyjnego
Test-WSMan -Authentication default
To polecenie sprawdza, czy usługa WS-Management (WinRM) jest uruchomiona na komputerze lokalnym przy użyciu parametru uwierzytelniania.
Użycie parametru uwierzytelniania umożliwia Test-WSMan
zwrócenie wersji systemu operacyjnego.
Przykład 4. Określanie stanu usługi WinRM i wersji systemu operacyjnego na komputerze zdalnym
Test-WSMan -ComputerName "server01" -Authentication default
To polecenie sprawdza, czy usługa WS-Management (WinRM) jest uruchomiona na komputerze o nazwie server01 przy użyciu parametru uwierzytelniania.
Użycie parametru uwierzytelniania umożliwia Test-WSMan
zwrócenie wersji systemu operacyjnego.
Parametry
-ApplicationName
Określa nazwę aplikacji w połączeniu. Wartość domyślna parametru ApplicationName to WSMAN. Kompletny identyfikator zdalnego punktu końcowego ma następujący format:
<Transport>://<Server>:<Port>/<ApplicationName>
Na przykład: http://server01:8080/WSMAN
Internet Information Services (IIS), który hostuje sesję, przekazuje żądania z tym punktem końcowym do określonej aplikacji. To domyślne ustawienie programu WSMAN jest odpowiednie dla większości zastosowań. Ten parametr jest przeznaczony do użycia, jeśli wiele komputerów nawiązuje połączenia zdalne z jednym komputerem z uruchomionym Windows PowerShell. W takim przypadku usługi IIS hostuje usługi sieci Web do zarządzania (WS-Management) w celu zwiększenia wydajności.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Authentication
Określa mechanizm uwierzytelniania, który ma być używany na serwerze. Dopuszczalne wartości dla 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.Default
— Użyj metody uwierzytelniania zaimplementowanej przez protokół WS-Management. Jest to opcja domyślna.- 1 — Skrót jest schematem odpowiedzi na wyzwanie, który używa ciągu danych określonego przez serwer do wyzwania.
Kerberos
— Komputer kliencki i serwer wzajemnie się uwierzytelniają przy użyciu certyfikatów Protokołu Kerberos.Negotiate
- Negocjacja jest schematem odpowiedzi na wyzwanie, który negocjuje z serwerem lub serwerem proxy w celu określenia schematu do użycia do uwierzytelniania. Na przykład ta wartość parametru umożliwia negocjacje w celu określenia, czy jest używany protokół Kerberos, czy NTLM.CredSSP
— Użyj uwierzytelniania dostawcy obsługi zabezpieczeń poświadczeń (CredSSP), co umożliwia użytkownikowi delegowanie poświadczeń. Ta opcja jest przeznaczona dla poleceń uruchamianych na jednym komputerze zdalnym, ale zbiera dane z lub uruchamia dodatkowe polecenia na innych komputerach zdalnych.
Przestroga
Dostawca CredSSP deleguje poświadczenia użytkownika z komputera lokalnego do komputera zdalnego. Ta praktyka zwiększa ryzyko bezpieczeństwa operacji zdalnej. Jeśli bezpieczeństwo komputera zdalnego zostanie naruszone, po przekazaniu do niego poświadczeń można użyć poświadczeń do kontrolowania sesji sieciowej.
Ważne
Jeśli nie określisz parametru Uwierzytelnianie , Test-WSMan
żądanie zostanie wysłane do komputera zdalnego anonimowo bez użycia uwierzytelniania. Jeśli żądanie jest wykonywane anonimowo, nie zwraca żadnych informacji specyficznych dla wersji systemu operacyjnego. Zamiast tego to polecenie cmdlet wyświetla wartości null dla wersji systemu operacyjnego i poziomu dodatku Service Pack (system operacyjny: 0.0.0 SP: 0.0).
Type: | AuthenticationMechanism |
Aliases: | auth, am |
Accepted values: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
Określa cyfrowy certyfikat klucza publicznego (X509) konta użytkownika z uprawnieniami do wykonania tej akcji. Wprowadź odcisk palca certyfikatu certyfikatu.
Certyfikaty są używane w uwierzytelnianiu opartym na certyfikatach klienta. Mogą być mapowane tylko na konta użytkowników lokalnych; nie działają z kontami domeny.
Aby uzyskać odcisk palca certyfikatu, użyj Get-Item lub Get-ChildItem
polecenia na dysku Windows PowerShell Cert:.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Określa komputer, na którym ma zostać uruchomiona operacja zarządzania. Wartość może być w pełni kwalifikowaną nazwą domeny, nazwą NetBIOS lub adresem IP. Użyj nazwy komputera lokalnego, użyj hosta lokalnego lub użyj kropki (.
), aby określić komputer lokalny. Komputer lokalny jest domyślny. Gdy komputer zdalny znajduje się w innej domenie niż użytkownik, należy użyć w pełni kwalifikowanej nazwy domeny. Możesz przekazać wartość tego parametru do polecenia cmdlet.
Type: | String |
Aliases: | cn |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Credential
Określa konto użytkownika, które ma uprawnienia do wykonania tej akcji. Wartość domyślna to użytkownik bieżący. Wpisz nazwę użytkownika, taką jak User01, Domain01\User01 lub User@Domain.com. Możesz też wprowadzić obiekt PSCredential , taki jak jeden zwrócony przez Get-Credential
polecenie cmdlet. Po wpiseniu nazwy użytkownika to polecenie cmdlet wyświetli monit o podanie hasła.
Type: | PSCredential |
Aliases: | cred, c |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Port
Określa port, który ma być używany, gdy klient łączy się z usługą WinRM. Gdy transport to HTTP, domyślny port to 80. Gdy transport to HTTPS, domyślny port to 443.
W przypadku używania protokołu HTTPS jako transportu wartość parametru ComputerName musi być zgodna z nazwą pospolitą certyfikatu serwera (CN).
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSSL
Określa, że protokół Secure Sockets Layer (SSL) jest używany do nawiązywania połączenia z komputerem zdalnym. Domyślnie nie jest używane szyfrowanie SSL.
WS-Management szyfruje całą zawartość Windows PowerShell przesyłaną przez sieć. Parametr UseSSL umożliwia określenie dodatkowej ochrony protokołu HTTPS zamiast protokołu HTTP. Jeśli protokół SSL nie jest dostępny na porcie używanym do połączenia i określisz ten parametr, polecenie kończy się niepowodzeniem.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
None
Nie można potokować obiektów do tego polecenia cmdlet.
Dane wyjściowe
To polecenie cmdlet zwraca obiekt XmlElement reprezentujący wynik testu.
Uwagi
Domyślnie Test-WSMan
polecenie cmdlet wysyła zapytanie do usługi WinRM bez użycia uwierzytelniania i nie zwraca żadnych informacji specyficznych dla wersji systemu operacyjnego. Zamiast tego wyświetla wartości null dla wersji systemu operacyjnego i poziomu dodatku Service Pack (system operacyjny: 0.0.0 SP: 0.0).