Test-WSMan

  • Reference
Modul:
Microsoft.WSMan.Management

Testuje, zda je služba WinRM spuštěna na místním nebo vzdáleném počítači.

Syntax

Test-WSMan
    [[-ComputerName] <String>]
    [-Authentication <AuthenticationMechanism>]
    [-Port <Int32>]
    [-UseSSL]
    [-ApplicationName <String>]
    [-Credential <PSCredential>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina Test-WSMan odešle žádost o identifikaci, která určuje, jestli je služba WinRM spuštěná na místním nebo vzdáleném počítači. Pokud testovaný počítač službu spouští, rutina zobrazí WS-Management schéma identity, verzi protokolu, dodavatele produktu a verzi produktu testované služby.

Příklady

Příklad 1: Určení stavu služby WinRM

Test-WSMan

Tento příkaz určuje, zda je služba WinRM spuštěna v místním nebo vzdáleném počítači.

Příklad 2: Určení stavu služby WinRM ve vzdáleném počítači

Test-WSMan -ComputerName "server01"

Tento příkaz určuje, jestli je služba WinRM spuštěná na počítači server01.

Příklad 3: Určení stavu služby WinRM a verze operačního systému

Test-WSMan -Authentication default

Tento příkaz pomocí parametru ověřování otestuje, jestli je v místním počítači spuštěná služba WS-Management (WinRM).

Použití parametru ověřování umožňuje Test-WSMan vrátit verzi operačního systému.

Příklad 4: Určení stavu služby WinRM a verze operačního systému ve vzdáleném počítači

Test-WSMan -ComputerName "server01" -Authentication default

Tento příkaz pomocí parametru ověřování otestuje, jestli je na počítači s názvem server01 spuštěná služba WS-Management (WinRM).

Použití parametru ověřování umožňuje Test-WSMan vrátit verzi operačního systému.

Parametry

-ApplicationName

Určuje název aplikace v připojení. Výchozí hodnota parametru ApplicationName je WSMAN. Úplný identifikátor vzdáleného koncového bodu je v následujícím formátu:

<Transport>://<Server>:<Port>/<ApplicationName>

Příklad: http://server01:8080/WSMAN

Internetová informační služba (IIS), která hostuje relaci, předává požadavky s tímto koncovým bodem zadané aplikaci. Toto výchozí nastavení WSMAN je vhodné pro většinu použití. Tento parametr je určen k použití, pokud mnoho počítačů naváže vzdálené připojení k jednomu počítači se systémem Windows PowerShell. V tomto případě služba IIS kvůli efektivitě hostuje webové služby pro správu (WS-Management).

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

-Authentication

Určuje mechanismus ověřování, který se má použít na serveru. Tento parametr přijímá tyto hodnoty:

  • Basic – Základní je schéma, ve kterém se uživatelské jméno a heslo odesílají jako prostý text na server nebo proxy server.
  • Default – Použijte metodu ověřování implementovanou protokolem WS-Management. Tato možnost je výchozí.
  • 1 – Hodnota hash je schéma výzvy a odpovědi, které pro výzvu používá datový řetězec zadaný serverem.
  • Kerberos – Klientský počítač a server se vzájemně ověřují pomocí certifikátů Kerberos.
  • Negotiate - Negotiate je schéma výzvy a odpovědi, které vyjednává se serverem nebo proxy serverem o určení schématu, které se má použít pro ověřování. Tato hodnota parametru například umožňuje vyjednávání k určení, jestli se používá protokol Kerberos nebo NTLM.
  • CredSSP – Použijte ověřování CredSSP (Credential Security Support Provider), které uživateli umožňuje delegovat přihlašovací údaje. Tato možnost je určená pro příkazy, které běží na jednom vzdáleném počítači, ale shromažďují data z jiných vzdálených počítačů nebo spouštějí další příkazy.

Upozornění

CredSSP deleguje přihlašovací údaje uživatele z místního počítače na vzdálený počítač. Tento postup zvyšuje bezpečnostní riziko vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače a jsou mu předány přihlašovací údaje, mohou být přihlašovací údaje použity k řízení síťové relace.

Důležité

Pokud nezadáte parametr Ověřování , Test-WSMan odešle se žádost do vzdáleného počítače anonymně bez použití ověřování. Pokud je požadavek proveden anonymně, nevrátí žádné informace specifické pro verzi operačního systému. Místo toho tato rutina zobrazí hodnoty null pro verzi operačního systému a úroveň aktualizace Service Pack (operační systém: 0.0.0 SP: 0.0).

Type:Microsoft.WSMan.Management.AuthenticationMechanism
Aliases:auth, am
Accepted values:None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CertificateThumbprint

Určuje certifikát digitálního veřejného klíče (X509) uživatelského účtu, který má oprávnění k provedení této akce. Zadejte kryptografický otisk certifikátu.

Certifikáty se používají při ověřování na základě klientských certifikátů. Mohou být mapovány pouze na místní uživatelské účty; nefungují s doménovými účty.

Kryptografický otisk certifikátu získáte pomocí Get-Item nebo Get-ChildItem příkazu v jednotce Windows PowerShell Cert: .

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

-ComputerName

Určuje počítač, na kterém se má operace správy spustit. Hodnotou může být plně kvalifikovaný název domény, název NetBIOS nebo IP adresa. Použijte název místního počítače, localhost nebo tečku (.) k určení místního počítače. Místní počítač je výchozí. Pokud je vzdálený počítač v jiné doméně než uživatel, musíte použít plně kvalifikovaný název domény. Hodnotu tohoto parametru můžete předvést do rutiny .

Type:String
Aliases:cn
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Ve výchozím nastavení je to aktuální uživatel. Zadejte uživatelské jméno, například User01, Domain01\User01 nebo User@Domain.com. Nebo zadejte objekt PSCredential , například objekt vrácený rutinou Get-Credential . Když zadáte uživatelské jméno, tato rutina vás vyzve k zadání hesla.

Type:PSCredential
Aliases:cred, c
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Port

Určuje port, který se má použít při připojení klienta ke službě WinRM. Pokud je přenos http, výchozí port je 80. Pokud je přenos HTTPS, výchozí port je 443.

Pokud jako přenos použijete HTTPS, hodnota parametru ComputerName musí odpovídat běžnému názvu certifikátu serveru.

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

-UseSSL

Určuje, že se k navázání připojení ke vzdálenému počítači použije protokol SSL (Secure Sockets Layer). Ve výchozím nastavení se protokol SSL nepoužívá.

WS-Management šifruje veškerý Windows PowerShell obsah přenášený přes síť. Parametr UseSSL umožňuje zadat dodatečnou ochranu HTTPS místo HTTP. Pokud na portu, který se používá pro připojení, není k dispozici protokol SSL a zadáte tento parametr, příkaz se nezdaří.

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

Vstupy

None

Objekty nelze do této rutiny převést.

Výstupy

None

Tato rutina nevrací žádný výstup.

Poznámky

Rutina Test-WSMan ve výchozím nastavení dotazuje službu WinRM bez použití ověřování a nevrací žádné informace, které jsou specifické pro verzi operačního systému. Místo toho zobrazuje hodnoty null pro verzi operačního systému a úroveň aktualizace Service Pack (operační systém: 0.0.0 SP: 0.0).