Get-WSManInstance

Referenz

Modul:: Microsoft.WSMan.Management

Zeigt Verwaltungsinformationen für eine durch einen Ressourcen-URI angegebene Ressourceninstanz an.

Syntax

Get-WSManInstance
   [-ApplicationName <String>]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-ResourceURI] <Uri>
   [-SelectorSet <Hashtable>]
   [-SessionOption <SessionOption>]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Get-WSManInstance
   [-ApplicationName <String>]
   [-BasePropertiesOnly]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Enumerate]
   [-Filter <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-Associations]
   [-ResourceURI] <Uri>
   [-ReturnType <String>]
   [-SessionOption <SessionOption>]
   [-Shallow]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Beschreibung

Das Get-WSManInstance Cmdlet ruft eine instance einer Verwaltungsressource ab, die durch einen Ressourcen-URI (Uniform Resource Identifier) angegeben wird. Die abgerufenen Informationen können ein komplexer XML-Informationssatz sein, bei dem es sich um ein Objekt oder um einen einfachen Wert handelt. Dieses Cmdlet entspricht dem Standardbefehl "Webdienste für die Verwaltung (WS-Management) Get ".

Das Cmdlet verwendet die Verbindungs-/Transportschicht von WS-Management zum Abrufen von Informationen.

Beispiele

Beispiel 1: Abrufen aller Informationen aus WMI

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="winrm"} -ComputerName "Server01"

Dieser Befehl gibt alle Informationen zurück, die die Windows-Verwaltungsinstrumentation (WMI) zum WinRM-Dienst auf dem Remotecomputer server01 verfügbar macht.

Beispiel 2: Abrufen der status des Spooler-Diensts

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="spooler"} -Fragment Status -ComputerName "Server01"

Dieser Befehl gibt nur die status des Spooler-Diensts auf dem Remotecomputer server01 zurück.

Beispiel 3: Abrufen von Endpunktverweise für alle Dienste

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/win32_service -ReturnType EPR

Dieser Befehl gibt Endpunktverweise zurück, die allen Diensten auf dem lokalen Computer entsprechen.

Beispiel 4: Abrufen von Diensten, die die angegebenen Kriterien erfüllen

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/* -Filter "select * from win32_service where StartMode = 'Auto' and State = 'Stopped'" -ComputerName "Server01"

Dieser Befehl listet alle Dienste auf, die die folgenden Kriterien auf dem Remotecomputer Server01 erfüllen:

Der Starttyp des Diensts ist Automatisch.
Der -Dienst wurde beendet.

Beispiel 5: Abrufen der Listenerkonfiguration, die Kriterien auf dem lokalen Computer entspricht

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"}

Dieser Befehl listet die WS-Management-Listenerkonfiguration auf dem lokalen Computer für den Listener auf, der den Kriterien im Selektorsatz entspricht.

Beispiel 6: Abrufen der Listenerkonfiguration, die Kriterien auf einem Remotecomputer erfüllt

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"} -ComputerName "Server01"

Dieser Befehl listet die WS-Management-Listenerkonfiguration auf dem Remotecomputer server01 für den Listener auf, der den Kriterien im Selektorsatz entspricht.

Beispiel 7: Abrufen zugeordneter Instanzen im Zusammenhang mit einer angegebenen instance

Get-WSManInstance -Enumerate -Dialect Association -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

Dieser Befehl ruft die assoziierten Instanzen ab, die mit der angegebenen Instanz (winrm) verknüpft sind.

Sie müssen den Filter in Anführungszeichen einschließen, wie im Beispiel gezeigt.

Beispiel 8: Abrufen von Zuordnungsinstanzen im Zusammenhang mit einem angegebenen instance

Get-WSManInstance -Enumerate -Dialect Association -Associations -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

Dieser Befehl ruft die Assoziationsinstanzen ab, die mit der angegebenen Instanz (winrm) verknüpft sind. Da der Dialekt-Wert zuordnung ist und der Associations-Parameter verwendet wird, gibt dieser Befehl Zuordnungsinstanzen und keine zugeordneten Instanzen zurück.

Sie müssen den Filter in Anführungszeichen einschließen, wie im Beispiel gezeigt.

Parameter

-ApplicationName

Gibt den Anwendungsnamen in der Verbindung an. Der Standardwert des ApplicationName-Parameters ist WSMAN. Der vollständige Bezeichner für den Remoteendpunkt hat das folgende Format:

Beispiel: http://server01:8080/WSMAN

Die Sitzung wird von IIS (Internetinformationsdienste) gehostet. IIS leitet Anforderungen mit diesem Endpunkt an die angegebene Anwendung weiter. Diese Standardeinstellung von WSMAN ist für die meisten Verwendungszwecke geeignet. Dieser Parameter ist für die Verwendung konzipiert, wenn viele Computer Remoteverbindungen mit einem Computer herstellen, auf dem PowerShell ausgeführt wird. In diesem Fall hostet IIS WS-Management aus Effizienzgründen.

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

-Associations

Gibt an, dass dieses Cmdlet Zuordnungsinstanzen und keine zugeordneten Instanzen abruft. Sie können diesen Parameter nur verwenden, wenn der Dialekt-Parameter über den Wert Association verfügt.

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

-Authentication

Gibt den Authentifizierungsmechanismus an, der auf dem Server verwendet werden soll. Zulässige Werte für diesen Parameter:

Basic - Basic ist ein Schema, bei dem der Benutzername und das Kennwort in Klartext an den Server oder Proxy gesendet werden.
Default – Verwenden Sie die vom WS-Management-Protokoll implementierte Authentifizierungsmethode. Dies ist die Standardoption.
Digest – Digest ist ein Challenge-Antwort-Schema, das eine serverspezifische Datenzeichenfolge für die Herausforderung verwendet.
Kerberos – Der Clientcomputer und der Server authentifizieren sich gegenseitig mithilfe von Kerberos-Zertifikaten.
Negotiate – Negotiate ist ein Challenge-Response-Schema, das mit dem Server oder Proxy aushandelt, um das für die Authentifizierung zu verwendende Schema zu bestimmen. Dieser Parameterwert ermöglicht beispielsweise die Aushandlung, um zu bestimmen, ob das Kerberos-Protokoll oder NTLM verwendet wird.
CredSSP – Verwenden Sie die CredSSP-Authentifizierung (Credential Security Support Provider), mit der der Benutzer Anmeldeinformationen delegieren kann. Diese Option ist für Befehle vorgesehen, die auf einem Remotecomputer ausgeführt werden, jedoch Daten von anderen Remotecomputern sammeln oder zusätzliche Befehle auf anderen Remotecomputern ausführen.

Achtung

CredSSP delegiert die Benutzeranmeldeinformationen vom lokalen Computer an einen Remotecomputer. Dieser Vorgang erhöht das Sicherheitsrisiko des Remotevorgangs. Wenn die Sicherheit des Remotecomputers gefährdet ist, während Anmeldeinformationen an ihn übergeben werden, können die Anmeldeinformationen zum Steuern der Netzwerksitzung verwendet werden.

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

-BasePropertiesOnly

Gibt an, dass dieses Cmdlet nur die Eigenschaften aufzählt, die Teil der Basisklasse sind, die vom ResourceURI-Parameter angegeben wird. Dieser Parameter hat keine Auswirkung, wenn der Parameter Shallow angegeben wird.

Type:	SwitchParameter
Aliases:	UBPO, Base
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Gibt das digitale Zertifikat für öffentliche Schlüssel (X509) eines Benutzerkontos an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Geben Sie den Zertifikatfingerabdruck des Zertifikats ein.

Zertifikate werden bei der clientzertifikatbasierten Authentifizierung verwendet. Sie können nur lokalen Benutzerkonten zugeordnet werden und funktionieren nicht mit Domänenkonten.

Verwenden Sie zum Abrufen eines Zertifikatfingerabdrucks den Get-Item Befehl oder Get-ChildItem im PowerShell-Laufwerk Cert: .

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

-ComputerName

Gibt den Computer an, auf dem 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. Verwenden Sie den Namen des lokalen Computers, verwenden Sie localhost, oder verwenden Sie einen Punkt (.), um den lokalen Computer anzugeben. Der lokale Computer ist die Standardeinstellung. Wenn sich der Remotecomputer in einer anderen Domäne als der Benutzer befindet, müssen Sie einen vollqualifizierten Domänennamen verwenden. Sie können einen Wert für diesen Parameter an das Cmdlet weiterreichen.

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

-ConnectionURI

Gibt den Verbindungsendpunkt an. Das Format dieser Zeichenfolge lautet wie folgt:

Die folgende Zeichenfolge ist ein richtig formatierter Wert für diesen Parameter:

http://Server01:8080/WSMAN

Der URI muss vollqualifiziert sein.

Type:	Uri
Aliases:	CURI, CU
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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. Oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Get-Credential Cmdlet zurückgegebenes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie von diesem Cmdlet zur Eingabe eines Kennworts aufgefordert.

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

-Dialect

Gibt den im Filterprädikat zu verwendenden Dialekt an. Dies kann ein beliebiger vom Remotedienst unterstützter Dialekt sein. Die folgenden Aliase können für den Dialekt-URI verwendet werden:

WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
Selector- http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
Verband- http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

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

-Enumerate

Gibt an, dass dieses Cmdlet alle Instanzen einer Verwaltungsressource zurückgibt.

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

-Filter

Gibt den Filterausdruck für die Enumeration an. Wenn Sie diesen Parameter angeben, müssen Sie auch Dialekt angeben.

Die gültigen Werte dieses Parameters hängen vom Dialekt ab, der in Dialekt angegeben ist. Wenn dialekt beispielsweise WQL ist, muss der Parameter Filter eine Zeichenfolge enthalten, und die Zeichenfolge muss eine gültige WQL-Abfrage wie die folgende Abfrage enthalten:

"Select * from Win32_Service where State != Running"

Wenn Dialekt auf Zuordnung festgelegt ist, muss Filter eine Zeichenfolge enthalten, und die Zeichenfolge muss einen gültigen Filter enthalten, z. B. den folgenden Filter:

-filter:Object=EPR\[;AssociationClassName=AssocClassName\]\[;ResultClassName=ClassName\]\[;Role=RefPropertyName\]\[;ResultRole=RefPropertyName\]}

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

-Fragment

Gibt einen Abschnitt innerhalb der Instanz an, die aktualisiert oder für den angegebenen Vorgang abgerufen werden soll. Geben Sie beispielsweise Folgendes an, um die status eines Spoolerdiensts abzurufen:

-Fragment Status

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

-OptionSet

Gibt einen Satz von Schaltern zu einem Dienst an, um die Art der Anforderung zu ändern oder zu verfeinern. Diese ähneln Schaltern, die in Befehlszeilenshells verwendet werden, da sie dienstspezifisch sind. Es kann eine beliebige Anzahl von Optionen angegeben werden.

Das folgende Beispiel veranschaulicht die Syntax, durch die die Werte 1, 2 und 3 für die Parameter „a“, „b“ und „c“ übergeben werden:

-OptionSet @{a=1;b=2;c=3}

Type:	Hashtable
Aliases:	OS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Port

Gibt den Port an, der verwendet wird, wenn der Client eine Verbindung mit dem WinRM-Dienst herstellt. Wenn der Transport auf HTTP festgelegt ist, lautet der Standardport 80. Wenn der Transport auf HTTPS festgelegt ist, lautet der Standardport 443.

Wenn Sie HTTPS als Transport verwenden, muss der Wert des Parameters ComputerName mit dem Zertifikat common name (CN) des Servers übereinstimmen. Wenn der SkipCNCheck-Parameter jedoch als Teil des SessionOption-Parameters angegeben wird, muss der allgemeine Zertifikatname des Servers nicht mit dem Hostnamen des Servers übereinstimmen. Der SkipCNCheck-Parameter sollte nur für vertrauenswürdige Computer verwendet werden.

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

-ResourceURI

Gibt den URI der Ressourcenklasse oder des instance an. Der URI identifiziert einen bestimmten Ressourcentyp, z. B. Datenträger oder Prozesse, auf einem Computer.

Ein URI besteht aus einem Präfix und einem Pfad einer Ressource. Beispiel:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Type:	Uri
Aliases:	RURI
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReturnType

Gibt den Typ der zurückzugebenden Daten an. Zulässige Werte für diesen Parameter:

Object
EPR
ObjectAndEPR

Standardwert: Object.

Wenn Sie diesen Parameter angeben Object oder nicht angeben, gibt dieses Cmdlet nur Objekte zurück. Wenn Sie endpunktverweis (Endpoint Reference, EPR) angeben, gibt dieses Cmdlet nur die Endpunktverweise der Objekte zurück. Endpunktverweise enthalten Informationen zum Ressourcen-URI und den Selektoren für die Instanz. Wenn Sie angeben ObjectAndEPR, gibt dieses Cmdlet sowohl das Objekt als auch die zugehörigen Endpunktverweise zurück.

Type:	String
Aliases:	RT
Accepted values:	object, epr, objectandepr
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SelectorSet

Gibt eine Reihe von Wertpaaren an, mit denen bestimmte Instanzen von Verwaltungsressourcen ausgewählt werden. Der SelectorSet-Parameter wird verwendet, wenn mehrere instance der Ressource vorhanden sind. Der Wert des SelectorSet-Parameters muss eine Hashtabelle sein.

Das folgende Beispiel zeigt, wie Sie einen Wert für diesen Parameter eingeben:

-SelectorSet @{Name="WinRM";ID="yyy"}

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

-SessionOption

Gibt erweiterte Optionen für die WS-Management-Sitzung an. Geben Sie ein SessionOption-Objekt ein, das Sie mit dem Cmdlet New-WSManSessionOption erstellen. Um weitere Informationen zu den verfügbaren Optionen zu erhalten, geben Sie ein Get-Help New-WSManSessionOption.

Type:	SessionOption
Aliases:	SO
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Shallow

Gibt an, dass dieses Cmdlet nur Instanzen der Basisklasse zurückgibt, die im Ressourcen-URI angegeben ist. Wenn Sie diesen Parameter nicht angeben, gibt dieses Cmdlet Instanzen der Basisklasse zurück, die im URI und in allen abgeleiteten Klassen angegeben ist.

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

-UseSSL

Gibt an, dass das SSL-Protokoll (Secure Sockets Layer) verwendet wird, um eine Verbindung mit dem Remotecomputer herzustellen. Standardmäßig wird SSL nicht verwendet.

WS-Management verschlüsselt alle Windows PowerShell-Inhalte, die über das Netzwerk übertragen werden. Mit dem UseSSL-Parameter können Sie den zusätzlichen Schutz von HTTPS anstelle von HTTP angeben. Wenn SSL für den Port, der für die Verbindung verwendet wird, nicht verfügbar ist und Sie diesen Parameter angeben, schlägt der Befehl fehl.

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

Eingaben

None

Sie können keine Objekte an dieses Cmdlet übergeben.

Ausgaben

XmlElement

Dieses Cmdlet gibt ein XMLElement-Objekt zurück.

Share via

Get-WSManInstance

Syntax

Beschreibung

Beispiele

Beispiel 1: Abrufen aller Informationen aus WMI

Beispiel 2: Abrufen der status des Spooler-Diensts

Beispiel 3: Abrufen von Endpunktverweise für alle Dienste

Beispiel 4: Abrufen von Diensten, die die angegebenen Kriterien erfüllen

Beispiel 5: Abrufen der Listenerkonfiguration, die Kriterien auf dem lokalen Computer entspricht

Beispiel 6: Abrufen der Listenerkonfiguration, die Kriterien auf einem Remotecomputer erfüllt

Beispiel 7: Abrufen zugeordneter Instanzen im Zusammenhang mit einer angegebenen instance

Beispiel 8: Abrufen von Zuordnungsinstanzen im Zusammenhang mit einem angegebenen instance

Parameter

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Eingaben

Ausgaben

Zusätzliche Ressourcen

Share via

Get-WSManInstance

Syntax

Beschreibung

Beispiele

Beispiel 1: Abrufen aller Informationen aus WMI

Beispiel 2: Abrufen der status des Spooler-Diensts

Beispiel 3: Abrufen von Endpunktverweise für alle Dienste

Beispiel 4: Abrufen von Diensten, die die angegebenen Kriterien erfüllen

Beispiel 5: Abrufen der Listenerkonfiguration, die Kriterien auf dem lokalen Computer entspricht

Beispiel 6: Abrufen der Listenerkonfiguration, die Kriterien auf einem Remotecomputer erfüllt

Beispiel 7: Abrufen zugeordneter Instanzen im Zusammenhang mit einer angegebenen instance

Beispiel 8: Abrufen von Zuordnungsinstanzen im Zusammenhang mit einem angegebenen instance

Parameter

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Eingaben

Ausgaben

Ähnliche Themen

Zusätzliche Ressourcen