Get-WSManInstance

Syntax

GetInstance (Standard)

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

Enumerate

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

Beschreibung

Beispiele

Beispiel 1: Abrufen aller Informationen aus WMI

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

Beispiel 2: Abrufen des Status des Spoolerdiensts

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

Beispiel 3: Abrufen von Endpunktverweisen für alle Dienste

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

Beispiel 4: Abrufen von Diensten, die den angegebenen Kriterien entsprechen

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

Beispiel 5: Abrufen der Listenerkonfiguration, die Kriterien auf dem lokalen Computer erfüllt

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

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

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

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

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

Beispiel 8: Abrufen von Zuordnungsinstanzen im Zusammenhang mit einer angegebenen Instanz

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

Parameter

-ApplicationName

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

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

Beispiel: http://server01:8080/WSMAN

Internetinformationsdienste (Internet Information Services, IIS), die die Sitzung hostet, leitet Anforderungen mit diesem Endpunkt an die angegebene Anwendung weiter. Diese Standardeinstellung von WSMAN ist für die meisten Anwendungen geeignet. Dieser Parameter soll verwendet werden, wenn viele Computer Remoteverbindungen mit einem Computer herstellen, auf dem PowerShell ausgeführt wird. In diesem Fall hosten IIS WS-Management zur Effizienz.

Parametereigenschaften

Parametersätze

-Associations

Gibt an, dass dieses Cmdlet Zuordnungsinstanzen abruft, nicht zugeordnete Instanzen. Sie können diesen Parameter nur verwenden, wenn der parameter Dialekt einen Wert von Association aufweist.

Parametereigenschaften

Parametersätze

-Authentication

Gibt den Authentifizierungsmechanismus an, der auf dem Server verwendet werden soll. Die zulässigen Werte für diesen Parameter sind:

• Basic – Einfach ist ein Schema, bei dem der Benutzername und das Kennwort klartext an den Server oder Proxy gesendet werden.
• Default – Verwenden Sie die vom WS-Management Protokoll implementierte Authentifizierungsmethode. Dies ist die Standardeinstellung.
• Digest – Digest ist ein Abfrageantwortschema, das eine serverspezifische Datenzeichenfolge für die Abfrage verwendet.
• Kerberos – Der Clientcomputer und der Server authentifizieren sich gegenseitig mithilfe von Kerberos-Zertifikaten.
• Negotiate – Negotiate ist ein Abfrageantwortschema, das mit dem Server oder Proxy aushandelt, um das schema zu bestimmen, das für die Authentifizierung verwendet werden soll. Mit diesem Parameterwert kann beispielsweise ermittelt werden, ob das Kerberos-Protokoll oder NTLM verwendet wird.
• CredSSP – Verwenden Sie die Authentifizierung des Credential Security Support Provider (CredSSP), mit der die Anmeldeinformationen des Benutzers delegiert werden können. Diese Option wurde für Befehle entwickelt, die auf einem Remotecomputer ausgeführt werden, aber Daten von anderen Remotecomputern sammeln oder zusätzliche Befehle ausführen.

Parametereigenschaften

Parametersätze

-BasePropertiesOnly

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

Parametereigenschaften

Parametersätze

-CertificateThumbprint

Gibt das Zertifikat für den digitalen öffentlichen 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 in der zertifikatbasierten Clientauthentifizierung verwendet. Sie können nur lokalen Benutzerkonten zugeordnet werden; sie funktionieren nicht mit Domänenkonten.

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

Parametereigenschaften

Parametersätze

-ComputerName

Gibt den Computer an, auf dem der Verwaltungsvorgang ausgeführt werden soll. Der Wert kann ein vollqualifizierter Domänenname, ein NetBIOS-Name oder eine IP-Adresse sein. Verwenden Sie den lokalen Computernamen, verwenden Sie "localhost", oder verwenden Sie einen Punkt (.), um den lokalen Computer anzugeben. Der lokale Computer ist der Standardwert. Wenn sich der Remotecomputer in einer anderen Domäne des Benutzers befindet, müssen Sie einen vollqualifizierten Domänennamen verwenden. Sie können einen Wert für diesen Parameter an das Cmdlet weiterleiten.

Parametereigenschaften

Parametersätze

-ConnectionURI

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

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

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

http://Server01:8080/WSMAN

Der URI muss vollständig qualifiziert sein.

Parametereigenschaften

Parametersätze

-Credential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Die Standardeinstellung ist der aktuelle Benutzer. Geben Sie einen Benutzernamen ein, z. B. "User01", "Domäne01\Benutzer01" oder "User@Domain.com". Oder geben Sie ein PSCredential--Objekt ein, z. B. ein objekt, das vom Cmdlet Get-Credential zurückgegeben wird. Wenn Sie einen Benutzernamen eingeben, werden Sie von diesem Cmdlet aufgefordert, ein Kennwort einzugeben.

Parametereigenschaften

Parametersätze

-Dialect

Gibt den Dialekt an, der im Filter-Prädikat verwendet werden soll. Dies kann jeder Dialekt sein, der vom Remotedienst unterstützt wird. Die folgenden Aliase können für den Dialekt-URI verwendet werden:

• WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
• Auswahl – http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• Zuordnung - http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Parametereigenschaften

Parametersätze

-Enumerate

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

Parametereigenschaften

Parametersätze

-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 Dialektangegeben ist. Wenn z. B. Dialekt- WQL ist, muss der parameter Filter eine Zeichenfolge enthalten, und die Zeichenfolge muss eine gültige WQL-Abfrage enthalten, z. B. die folgende Abfrage:

"Select * from Win32_Service where State != Running"

Wenn Dialekt- Zuordnung 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\]}

Parametereigenschaften

Parametersätze

-Fragment

Gibt einen Abschnitt innerhalb der Instanz an, der für den angegebenen Vorgang aktualisiert oder abgerufen werden soll. Wenn Sie beispielsweise den Status eines Spoolerdiensts abrufen möchten, geben Sie Folgendes an:

-Fragment Status

Parametereigenschaften

Parametersätze

-OptionSet

Gibt eine Reihe 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 können beliebig viele Optionen angegeben werden.

Im folgenden Beispiel wird die Syntax veranschaulicht, die die Werte 1, 2 und 3 für die Parameter a, b und c übergibt:

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

Parametereigenschaften

Parametersätze

-Port

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

Wenn Sie HTTPS als Transport verwenden, muss der Wert des ComputerName Parameter mit dem gemeinsamen Zertifikatnamen (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 parameter SkipCNCheck sollte nur für vertrauenswürdige Computer verwendet werden.

Parametereigenschaften

Parametersätze

-ResourceURI

Gibt den URI der Ressourcenklasse oder -instanz 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

Parametereigenschaften

Parametersätze

-ReturnType

Gibt den Datentyp an, der zurückgegeben werden soll. Die zulässigen Werte für diesen Parameter sind:

• Object
• EPR
• ObjectAndEPR

Der Standardwert ist Object.

Wenn Sie Object angeben oder diesen Parameter 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 über den Ressourcen-URI und die Selektoren für die Instanz. Wenn Sie ObjectAndEPRangeben, gibt dieses Cmdlet sowohl das Objekt als auch die zugehörigen Endpunktverweise zurück.

Parametereigenschaften

Parametersätze

-SelectorSet

Gibt eine Gruppe von Wertpaaren an, die zum Auswählen bestimmter Verwaltungsressourceninstanzen verwendet werden. Der SelectorSet Parameter wird verwendet, wenn mehrere Instanzen 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"}

Parametereigenschaften

Parametersätze

-SessionOption

Gibt erweiterte Optionen für die WS-Management Sitzung an. Geben Sie ein SessionOption-objekt ein, das Sie mithilfe des cmdlets New-WSManSessionOption erstellen. Wenn Sie weitere Informationen zu den verfügbaren Optionen erhalten möchten, geben Sie Get-Help New-WSManSessionOptionein.

Parametereigenschaften

Parametersätze

-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.

Parametereigenschaften

Parametersätze

-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 nicht für den Port verfügbar ist, der für die Verbindung verwendet wird, und Sie diesen Parameter angeben, schlägt der Befehl fehl.

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

None

Ausgaben

XmlElement

Ähnliche Themen

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