Test-WSMan

Artikel
10/30/2009

Testet, ob auf einem lokalen Computer oder Remotecomputer der WinRM-Dienst ausgeführt wird.

Syntax

Test-WSMan [[-ComputerName] <string>] [-Authentication <Authentication>] [-Credential <PSCredential>] [<CommonParameters>]

Beschreibung

Das Cmdlet "Test-WSMan" sendet eine Identifikationsanforderung, die ermittelt, ob der WinRM-Dienst auf einem lokalen oder einem Remotecomputer ausgeführt wird. Wenn der Dienst auf dem getesteten Computer ausgeführt wird, zeigt das Cmdlet das Identitätsschema der WS-Verwaltung, die Protokollversion, den Produktanbieter und die Produktversion des getesteten Diensts an.

Parameter

-Authentication <Authentication>

Gibt den Authentifizierungsmechanismus an, der auf dem Server verwendet werden soll. Mögliche Werte sind:

– Basic: Bei "Basic" handelt es sich um ein Schema, bei dem der Benutzername und das Kennwort im Klartext an den Server oder Proxy gesendet werden.

– Default: Verwendung der vom WS-Verwaltungsprotokoll implementierten Authentifizierungsmethode.

– Digest: Bei "Digest" handelt es sich um ein Abfrage-/Rückmeldungsschema, bei dem eine vom Server angegebene Datenzeichenfolge für die Abfrage verwendet wird.

– Kerberos: Der Clientcomputer und der Server führen eine gegenseitige Authentifizierung mit Kerberos-Zertifikaten aus.

– Negotiate: Bei "Negotiate" handelt es sich um ein Abfrage-/Rückmeldungsschema, bei dem das für die Authentifizierung zu verwendende Schema mit dem Server oder Proxy ausgehandelt wird. Dieser Parameter ermöglicht z. B. das Aushandeln, ob das Kerberos-Protokoll oder NTLM verwendet wird.

– CredSSP: Die CredSSP (Credential Security Service Provider)-Authentifizierung wird verwendet. Dies ermöglicht dem Benutzer das Delegieren der Anmeldeinformationen. Diese Option ist für Befehle vorgesehen, die auf einem Remotecomputer ausgeführt werden, jedoch Daten von anderen Remotecomputern erfassen oder zusätzliche Befehle auf anderen Remotecomputern ausführen.

Vorsicht: Mit CredSSP werden die Anmeldeinformationen des Benutzers vom lokalen Computer an einen Remotecomputer delegiert. Dieses Verfahren erhöht das Sicherheitsrisiko des Remotevorgangs. Wenn die Sicherheit des Remotecomputers beim Übergeben von Anmeldeinformationen an diesen gefährdet ist, können die Anmeldeinformationen zum Steuern der Netzwerksitzung verwendet werden.

Wichtig: Wenn der Authentifizierungsparameter nicht angegeben ist, wird die Test-WSMan-Anforderung anonym (ohne Authentifizierung) an den Remotecomputer gesendet. Wenn die Test-WSMan-Anforderung anonym gestellt wird, werden keine Informationen zurückgegeben, die für die Betriebssystemversion spezifisch sind. Stattdessen zeigt Test-WSMan für die Betriebssystemversion und die Service Pack-Ebene jeweils Werte von 0 an (OS: 0.0.0 SP: 0.0).

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-ComputerName <string>

Gibt den Computer an, für den der Verwaltungsvorgang ausgeführt werden soll. Bei dem Wert kann es sich um einen vollqualifizierten Domänennamen, einen NetBIOS-Namen oder eine IP-Adresse handeln. Um den Namen des lokalen Computers anzugeben, verwenden Sie den Computernamen, "localhost" oder einen Punkt (.). Der lokale Computer ist der Standardwert. Wenn sich der Remotecomputer in einer anderen Domäne als der Benutzer befindet, müssen Sie einen vollqualifizierten Domänennamen verwenden.

Erforderlich?	false
Position?	1
Standardwert	localhost
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Credential <PSCredential>

Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert ist der aktuelle Benutzer. Geben Sie einen Benutzernamen ein, z. B. "User01", "Domain01\User01" oder "User@Domain.com". Sie können auch ein PSCredential-Objekt eingeben, z. B. ein Objekt, das vom Cmdlet "Get-Credential" zurückgegeben wurde. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

Keiner

Dieses Cmdlet akzeptiert keine Eingabe.

Ausgaben

Keiner

Von diesem Cmdlet wird kein Ausgabeobjekt generiert.

Hinweise

Standardmäßig fragt das Cmdlet "Test-WSMan" den WinRM-Dienst ohne Authentifizierung ab, und es gibt keine Informationen zurück, die für die Betriebssystemversion spezifisch sind. Stattdessen zeigt es für die Betriebssystemversion und die Service Pack-Ebene jeweils Werte von 0 an (OS: 0.0.0 SP: 0.0).

Beispiel 1

C:\PS>test-wsman

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 0.0.0 SP: 0.0 Stack: 2.0

Beschreibung
-----------
Mit diesem Befehl bestimmen Sie, ob der WinRM-Dienst auf dem lokalen Computer oder auf einem Remotecomputer ausgeführt wird.

Beispiel 2

C:\PS>test-wsman -computername server01

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 0.0.0 SP: 0.0 Stack: 2.0

Beschreibung
-----------
Mit diesem Befehl bestimmen Sie, ob der WinRM-Dienst auf dem Computer "server01" ausgeführt wird.

Beispiel 3

C:\PS>test-wsman -authentication default

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 6.0.6001 SP: 1.0 Stack: 2.0

Beschreibung
-----------
Mit diesem Befehl testen Sie unter Verwendung des Authentifizierungsparameters, ob der WS-Verwaltungsdienst (WinRM) auf dem lokalen Computer ausgeführt wird.

Bei Verwendung des Authentifizierungsparameters kann das Cmdlet "Test-WSMan" die Betriebssystemversion zurückzugeben.

Beispiel 4

C:\PS>test-wsman -computername server01 -authentication default

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 6.1.7021 SP: 0.0 Stack: 2.0

Beschreibung
-----------
Mit diesem Befehl testen Sie unter Verwendung des Authentifizierungsparameters, ob der WS-Verwaltungsdienst (WinRM) auf dem Computer "server01" ausgeführt wird.

Bei Verwendung des Authentifizierungsparameters kann das Cmdlet "Test-WSMan" die Betriebssystemversion zurückzugeben.

Siehe auch

Konzepte

Connect-WSMan
Disable-WSManCredSSP
Disconnect-WSMan
Enable-WSManCredSSP
Get-WSManCredSSP
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
New-WSManSessionOption
Remove-WSManInstance
Set-WSManInstance
Set-WSManQuickConfig

Freigeben über