Freigeben über

about_WSMan_Provider

  • Artikel

Anbietername

WSMan

Laufwerke

WSMan:

Kurze Beschreibung

Bietet Zugriff auf Web Services for Management (WS-Management)-Konfigurationsinformationen.

Detaillierte Beschreibung

Diese Informationen gelten nur für PowerShell, die unter Windows ausgeführt wird.

Mit dem WSMan-Anbieter für PowerShell können Sie WS-Management Konfigurationsdaten auf lokalen oder Remotecomputern hinzufügen, ändern, löschen und löschen.

Der WSMan-Anbieter macht ein PowerShell-Laufwerk mit einer Verzeichnisstruktur verfügbar, die einer logischen Gruppierung von WS-Management Konfigurationseinstellungen entspricht. Diese Gruppierungen werden als Container bezeichnet.

Ab Windows PowerShell 3.0 wurde der WSMan-Anbieter aktualisiert, um neue Eigenschaften für Sitzungskonfigurationen wie OutputBufferingMode zu unterstützen. Die Sitzungskonfigurationen werden als Elemente im Plug-In-Verzeichnis des WSMan: Laufwerks angezeigt, und die Eigenschaften werden als Elemente in jeder Sitzungskonfiguration angezeigt.

Der WSMan-Anbieter unterstützt die folgenden Cmdlets, die in diesem Artikel behandelt werden.

Hinweis

Sie können Befehle im WSMan: Laufwerk verwenden, um die Werte der neuen Eigenschaften zu ändern. Sie können das WSMan: Laufwerk in PowerShell 2.0 jedoch nicht verwenden, um Eigenschaften zu ändern, die in Windows PowerShell 3.0 eingeführt wurden. Obwohl kein Fehler generiert wird, sind die Befehle nicht wirksam Um diese Einstellungen zu ändern, verwenden Sie das WSMan-Laufwerk in Windows PowerShell 3.0.

Organisation des WSMan: Laufwerk

  • Client: Sie können verschiedene Aspekte des WS-Management Clients konfigurieren. Die Konfigurationsinformationen werden in der Registrierung gespeichert.

  • Dienst: Sie können verschiedene Aspekte des WS-Management-Diensts konfigurieren. Die Konfigurationsinformationen werden in der Registrierung gespeichert.

    Hinweis

    Die Dienstkonfiguration wird manchmal als Serverkonfiguration bezeichnet.

  • Shell: Sie können verschiedene Aspekte der WS-Management Shell konfigurieren, z. B. die Einstellung zum Zulassen des Remoteshellzugriffs (AllowRemoteShellAccess) und die maximale Anzahl gleichzeitig zulässiger Benutzer (MaxConcurrentUsers).

  • Listener: Sie können einen Listener erstellen und konfigurieren. Ein Listener ist ein Verwaltungsdienst, der das WS-Verwaltungsprotokoll zum Senden und Empfangen von Nachrichten implementiert.

  • Plug-Ins werden vom WS-Management-Dienst geladen und verwendet, um verschiedene Funktionen bereitzustellen. Standardmäßig stellt PowerShell drei Plug-Ins bereit:

    • Das Ereignisweiterleitungs-Plug-In.
    • Das Microsoft.PowerShell-Plug-In.
    • Das WMI-Anbieter-Plug-In (Windows Management Instrumentation). Diese drei Plug-Ins unterstützen die Ereignisweiterleitung, -konfiguration und den WMI-Zugriff.

  • ClientCertificate: Sie können ein Clientzertifikat erstellen und konfigurieren. Ein Clientzertifikat wird verwendet, wenn der WS-Verwaltungsclient zur Verwendung der Zertifikatsauthentifizierung konfiguriert ist.

Verzeichnishierarchie des WSMan-Anbieters

Die Verzeichnishierarchie des WSMan-Anbieters für den lokalen Computer lautet wie folgt.

WSMan:\localhost
--- Client
--- Service
--- Shell
--- Listener
------ <Specific_Listener>
--- Plugin
------ Event Forwarding Plugin
--------- InitializationParameters
--------- Resources
------------ Security
------ Microsoft.Powershell
--------- InitializationParameters
--------- Resources
------------ Security
------ WMI Provider
--------- InitializationParameters
--------- Resources
------------ Security
--- ClientCertificate

Die Verzeichnishierarchie des WSMan-Anbieters für einen Remotecomputer ist identisch mit der für einen lokalen Computer. Um jedoch auf die Konfigurationseinstellungen eines Remotecomputers zugreifen zu können, müssen Sie mithilfe von Connect-WSMan eine Verbindung mit dem Remotecomputer herstellen. Sobald eine Verbindung mit einem Remotecomputer hergestellt wurde, wird der Name des Remotecomputers beim Anbieter angezeigt.

WSMan:\<Remote_Computer_Name>

Dieser Befehl verwendet das Set-Location Cmdlet, um den aktuellen Speicherort in das WSMan: Laufwerk zu ändern.

Set-Location WSMan:

Um zu einem Dateisystemlaufwerk zurückzukehren, geben Sie den Namen des Laufwerks ein. Geben Sie z. B. ein.

Set-Location C:

Dieser Befehl verwendet den Set-Location Befehl, um den aktuellen Speicherort in den Stammspeicherort im Remotesystemspeicherort zu ändern. Verwenden Sie einen umgekehrten Schrägstrich \ oder Schrägstrich / , um eine Ebene des WSMan: Laufwerks anzugeben.

Set-Location -Path  WSMan:\SERVER01

Hinweis

Der obige Befehl geht davon aus, dass bereits eine Verbindung mit dem Remotesystem vorhanden ist.

Anzeigen des Inhalts des WSMan:Laufwerks

Dieser Befehl verwendet das Get-Childitem Cmdlet, um die WS-Management-Speicher im Localhost-Speicherspeicherort anzuzeigen.

Get-ChildItem -path WSMan:\Localhost

Wenn Sie sich im WSMan: Laufwerk befinden, können Sie den Namen des Laufwerks weglassen.

Dieser Befehl verwendet das Get-Childitem Cmdlet, um die WS-Management-Speicher im Speicherort des Remotecomputers "SERVER01" anzuzeigen.

Get-ChildItem -path WSMan:\SERVER01

Hinweis

Der obige Befehl geht davon aus, dass bereits eine Verbindung mit dem Remotesystem vorhanden ist.

Festlegen des Werts von Elementen im Laufwerk WSMAN:

Sie können das Set-Item Cmdlet verwenden, um die Konfigurationseinstellungen auf dem WSMAN Laufwerk zu ändern. Im folgenden Beispiel wird der TrustedHosts-Wert so festgelegt, dass alle Hosts mit dem Suffix "contoso.com" akzeptiert werden.

# You do not need to specify the -Path parameter name when using Set-Item.
PS WSMAN:\localhost\Client> Set-Item .\TrustedHosts -Value "*.contoso.com"

Das Set-Item Cmdlet unterstützt einen zusätzlichen Parameter -Concatenate , der einen Wert angibt, anstatt ihn zu ändern. Im folgenden Beispiel wird ein neuer Wert "*.domain2.com" an den alten Wert angefügt, der in gespeichert ist. TrustedHost:

Set-Item WSMAN:\localhost\Client\TrustedHosts *.domain2.com -Concatenate

Erstellen von Elementen im WSMAN-Laufwerk:

Erstellen eines neuen Listeners

Das New-Item Cmdlet erstellt Elemente innerhalb eines Anbieterlaufwerks. Jeder Anbieter verfügt über unterschiedliche Elementtypen, die Sie erstellen können. Auf dem WSMAN: Laufwerk können Sie Listener erstellen, die Sie zum Empfangen und Beantworten von Remoteanforderungen konfigurieren. Mit dem folgenden Befehl wird mithilfe des New-Item Cmdlets ein neuer HTTP-Listener erstellt.

New-Item -Path WSMan:\localhost\Listener -Address * -Transport HTTP -force

Erstellen eines neuen Plug-Ins

Dieser Befehl erstellt (registriert) ein Plug-In für den WS-Verwaltungsdienst.

New-Item -Path WSMan:\localhost\Plugin `
         -Plugin TestPlugin `
         -FileName %systemroot%\system32\WsmWmiPl.dll `
         -Resource http://schemas.dmtf.org/wbem/wscim/2/cim-schema `
         -SDKVersion 1 `
         -Capability "Get","Put","Invoke","Enumerate" `
         -XMLRenderingType text

Erstellen eines neuen Ressourceneintrags

Mit diesem Befehl wird ein Ressourceneintrag im Ressourcenverzeichnis eines TestPlugins erstellt. Bei diesem Befehl wird davon ausgegangen, dass ein TestPlugin mithilfe eines separaten Befehls erstellt wurde.

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\Resources `
         -ResourceUri http://schemas.dmtf.org/wbem/wscim/3/cim-schema `
         -Capability "Enumerate"

Erstellen eines neuen Sicherheitseintrags für eine Ressource

Dieser Befehl erstellt einen Eintrag für die Sicherheit im Verzeichnis "Security" von Resource_5967683 (eine bestimmte Ressource). Bei diesem Befehl wird davon ausgegangen, dass der Ressourceneintrag mithilfe eines separaten Befehls erstellt wurde.

$path = "WSMan:\localhost\Plugin\TestPlugin\Resources\Resource_5967683"
New-Item -Path $path\Security `
         -Sddl "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GWGX;;;WD)"

Erstellen eines neuen Clientzertifikats

Mit diesem Befehl wird der ClientCertificate-Eintrag erstellt, der vom WS-Management-Client verwendet werden kann. Das neue ClientCertificate wird im Verzeichnis ClientCertificate als "ClientCertificate_1234567890" angezeigt. Alle Parameter müssen angegeben werden. Der Aussteller muss ein Fingerabdruck des Ausstellerzertifikats sein.

$cred = Get-Credential
New-Item -Path WSMan:\localhost\ClientCertificate `
         -Issuer 1b3fd224d66c6413fe20d21e38b304226d192dfe `
         -URI wmicimv2/* `
         -Credential $cred;

Erstellen eines neuen Initialisierungsparameters

Dieser Befehl erstellt einen Initialisierungsparameter namens "testparametername" im Verzeichnis "InitializationParameters". Bei diesem Befehl wird davon ausgegangen, dass "TestPlugin" mithilfe eines separaten Befehls erstellt wurde.

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\InitializationParameters `
         -ParamName testparametername `
         -ParamValue testparametervalue

Dynamische Parameter

Dynamische Parameter sind Cmdletparameter, die von einem PowerShell-Anbieter hinzugefügt werden und nur verfügbar sind, wenn das Cmdlet auf dem Laufwerk mit Anbieteraktivierung verwendet wird.

Adresszeichenfolge <>

Gibt die Adresse an, für die der Listener erstellt wurde. Der Wert kann in folgenden Formen vorliegen:

  • Die Literalzeichenfolge "*". (Mit dem Feldhalterzeichen (*) bindet der Befehl alle IP-Adressen auf allen Netzwerkadaptern.)
  • Die Literalzeichenfolge "IP:" gefolgt von einer gültigen IP-Adresse im IPv4-Dezimalformat oder im IPv6-Format geklont-hexadezimal.
  • Die Literalzeichenfolge "MAC:" gefolgt von der MAC-Adresse eines Adapters. Beispiel: MAC:32-a3-58-90-be-cc.

Hinweis

Der Wert der Adresse wird beim Erstellen eines Listeners festgelegt.

Unterstützte Cmdlets

Funktionsaufzählung <>

Beim Arbeiten mit Plug-Ins gibt dieser Parameter einen Vorgang an, der für diesen URI (Uniform Resource Identifier) unterstützt wird. Sie müssen einen Eintrag für jede Art von Vorgang erstellen, die der URI unterstützt. Sie können alle gültigen Attribute für einen bestimmten Vorgang angeben, wenn der Vorgang dies unterstützt.

Zu diesen Attributen gehören SupportsFiltering und SupportsFragment.

  • Create: Create-Vorgänge werden für den URI unterstützt.
    • Das Attribut SupportFragment wird verwendet, wenn der Create-Vorgang das Konzept unterstützt.
    • Das SupportFiltering-Attribut ist nicht für Create-Vorgänge gültig und sollte auf "False" festgelegt werden.

    Hinweis

    Dieser Vorgang ist nicht für einen URI gültig, wenn auch Shell-Vorgänge unterstützt werden.

  • Löschen: Löschvorgänge werden für den URI unterstützt.
    • Das SupportFragment-Attribut wird verwendet, wenn der Delete-Vorgang das Konzept unterstützt.
    • Das SupportFiltering-Attribut ist nicht für Delete-Vorgänge gültig und sollte auf "False" festgelegt werden.

    Hinweis

    Dieser Vorgang ist nicht für einen URI gültig, wenn auch Shell-Vorgänge unterstützt werden.

  • Aufzählen: Aufzählungsvorgänge werden für den URI unterstützt.
    • Das SupportFragment-Attribut wird für Enumerate-Vorgänge NICHT unterstützt und sollte auf False festgelegt werden.
    • Das SupportFiltering-Attribut ist gültig, und wenn das Plug-In filtert, sollte dieses Attribut auf "True" festgelegt werden.

    Hinweis

    Dieser Vorgang ist nicht für einen URI gültig, wenn auch Shell-Vorgänge unterstützt werden.

  • Get: Get-Vorgänge werden für den URI unterstützt.
    • Das Attribut SupportFragment wird verwendet, wenn der Get-Vorgang das Konzept unterstützt.
    • Das SupportFiltering-Attribut ist FÜR Get-Vorgänge NICHT gültig und sollte auf "False" festgelegt werden.

    Hinweis

    Dieser Vorgang ist nicht für einen URI gültig, wenn auch Shell-Vorgänge unterstützt werden.

  • Aufruf: Aufrufvorgänge werden für den URI unterstützt.
    • Das SupportFragment-Attribut wird für Invoke-Vorgänge nicht unterstützt und sollte auf False festgelegt werden.
    • Das SupportFiltering-Attribut ist ungültig und sollte auf "False" festgelegt werden.

    Hinweis

    Dieser Vorgang ist nicht für einen URI gültig, wenn auch Shell-Vorgänge unterstützt werden.

  • Put: Put-Vorgänge werden für den URI unterstützt.
    • Das Attribut SupportFragment wird verwendet, wenn der Put-Vorgang das Konzept unterstützt.
    • Das SupportFiltering-Attribut ist für Put-Vorgänge ungültig und sollte auf "False" festgelegt werden.

    Hinweis

    Dieser Vorgang ist nicht für einen URI gültig, wenn auch Shell-Vorgänge unterstützt werden.

  • Abonnieren: Abonnementvorgänge werden für den URI unterstützt.
    • Das SupportFragment-Attribut wird für Subscribe-Vorgänge nicht unterstützt und sollte auf False festgelegt werden.
    • Das SupportFiltering-Attribut ist für Subscribe-Vorgänge ungültig und sollte auf "False" festgelegt werden.

    Hinweis

    Dieser Vorgang ist nicht für einen URI gültig, wenn auch Shell-Vorgänge unterstützt werden.

  • Shell: Shellvorgänge werden für den URI unterstützt.
    • Das SupportFragment-Attribut wird für Shellvorgänge nicht unterstützt und sollte auf "False" festgelegt werden.
    • Das SupportFiltering-Attribut ist für Shellvorgänge ungültig und sollte auf "False" festgelegt werden.

    Hinweis

    Dieser Vorgang ist für einen URI ungültig, wenn JEDER andere Vorgang ebenfalls unterstützt wird.

    Hinweis

    Wenn ein Shell-Vorgang für eine URI konfiguriert ist, werden Get-, Put-, Create-, Delete-, Invoke- und Enumerate-Vorgänge intern innerhalb des WS-Verwaltungsdiensts (WinRM) zum Verwalten von Shells verarbeitet. Daher kann das Plug-In die Vorgänge nicht verarbeiten.

Unterstützte Cmdlets

CertificateThumbprint <String>

Gibt den Fingerabdruck des Dienstzertifikats an.

Dieser Wert repräsentiert die Zeichenfolge von zweistelligen Hexadezimalwerten im Fingerabdruckfeld des Zertifikats. Es gibt das digitale Zertifikat für öffentliche Schlüssel (X509) eines Benutzerkontos an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Zertifikate werden bei der clientzertifikatbasierten Authentifizierung verwendet. Sie können nur lokalen Benutzerkonten zugeordnet und nicht mit Domänenkonten verwendet werden. Verwenden Sie zum Abrufen eines Zertifikatfingerabdrucks die Get-Item Cmdlets oder Get-ChildItem auf dem PowerShell-Laufwerk Cert: .

Unterstützte Cmdlets

Boolean aktiviert <>

Gibt an, ob der Listener aktiviert oder deaktiviert ist. Der Standardwert ist True.

Unterstützte Cmdlets

FileName (Plug-In) <-Zeichenfolge>

Gibt den Dateinamen des Betriebs-Plug-Ins an. Alle Umgebungsvariablen, die in diesem Eintrag eingefügt werden, werden im Kontext der Benutzer erweitert, wenn eine Anforderung empfangen wird. Da jeder Benutzer eine andere Version derselben Umgebungsvariable haben könnte, kann jeder Benutzer über ein anderes Plug-In verfügen. Dieser Eintrag darf nicht leer sein und muss auf ein gültiges Plug-In verweisen.

Unterstützte Cmdlets

Hostnamenzeichenfolge <>

Gibt den Hostnamen des Computers an, auf dem der WS-Management-Dienst (WinRM) ausgeführt wird.

Bei diesem Wert muss es sich um einen vollständig qualifizierten Domänennamen, eine IPv4- oder IPv6-Literalzeichenfolge oder ein Platzhalterzeichen handeln.

Unterstützte Cmdlets

Ausstellerzeichenfolge <>

Gibt den Namen der Zertifizierungsstelle an, die das Zertifikat ausgestellt hat.

Unterstützte Cmdlets

Plug-Ins <> WS-Management Plug-Ins sind native Dynamic Link Libraries (DLLs)

, das die Funktionalität von WS-Management angibt und erweitert. Die WSW-Management-Plug-In-API bietet Funktionen, die es einem Benutzer ermöglichen, Plug-Ins zu schreiben, indem bestimmte APIs für unterstützte Ressourcen-URIs und Vorgänge implementiert werden. Nachdem die Plug-Ins entweder für den WS-Verwaltungsdienst (WinRM) oder für Internet Information Services (IIS) konfiguriert wurden, werden die Plug-Ins in den WS-Management-Host oder in den IIS-Host geladen. Remoteanforderungen werden an diese Plug-In-Einstiegspunkte für Operationen weitergeleitet.

Unterstützte Cmdlets

Port <unsigned Short Integer>

Gibt den TCP-Port an, für den der Listener erstellt wird. Sie können einen beliebigen Wert zwischen 1 und 65535 angeben.

Unterstützte Cmdlets

Ressourcenzeichenfolge <>

Gibt einen Endpunkt an, der einen unterschiedlichen Typ von Verwaltungsvorgang oder Wert darstellt. Ein Dienst macht eine oder mehrere Ressourcen verfügbar, und einige Ressourcen können mehr als eine Instanz aufweisen. Eine Management-Ressource ist vergleichbar mit einer WMI-Klasse oder einer Datenbanktabelle, und eine Instanz ist vergleichbar mit einer Instanz der Klasse oder einer Zeile in der Tabelle. Die Win32_LogicalDisk-Klasse stellt beispielsweise eine Ressource dar. Win32_LogicalDisk="C:\\"ist eine bestimmte instance der Ressource.

Ein Uniform Resource Identifier (URI) enthält ein Präfix und einen Pfad zu 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

Unterstützte Cmdlets

Ressourcenzeichenfolge <>

Gibt den Uniform Resource Identifier (URI) an, der eine bestimmte Art von Ressource identifiziert, z. B. ein Datenträger oder ein Prozess auf einem Computer.

Ein URI besteht aus einem Präfix und einem Pfad zu 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

Unterstützte Cmdlets

SDKVersion-Zeichenfolge <>

Gibt die Version des WS-Management-Plug-In-SDKs an. Der einzige gültige Wert ist 1.

Unterstützte Cmdlets

Betreffzeichenfolge <>

Gibt die Entität an, die durch das Zertifikat identifiziert wird.

Unterstützte Cmdlets

Transportzeichenfolge <>

Legt den Transport zum Senden und Empfangen von WS-Management-Protokollanforderungen und -antworten fest. Der Wert muss entweder HTTP oder HTTPS sein.

Hinweis: Der Transportwert wird beim Erstellen eines Listeners festgelegt.

Unterstützte Cmdlets

URI-Zeichenfolge <>

Gibt den URI an, für den der Zugriff basierend auf dem Wert des Parameters Sddl gewährt wird.

Unterstützte Cmdlets

URLPrefix-Zeichenfolge <>

Ein URL-Präfix für das Akzeptieren von HTTP- oder HTTPS-Anforderungen. Dies ist eine Zeichenfolge, die nur die Zeichen [a-z], [A-Z], [9-0], unterstrich (_) und umgekehrter Schrägstrich (/) enthält. Die Zeichenfolge darf nicht mit einem umgekehrten Schrägstrich (/) beginnen oder mit diesem enden. Wenn der Computername beispielsweise "SampleComputer" lautet, würde der WS-Management Client in der Zieladresse angeben http://SampleMachine/URLPrefix .

Unterstützte Cmdlets

Wertzeichenfolge <>

Gibt den Wert eines Initialisierungsparameters an, einem Plug-In-spezifischen Wert, der verwendet wird, um Konfigurationsoptionen anzugeben.

Unterstützte Cmdlets

XMLRenderingType <String>

Gibt das Format an, in dem XML über das WSMAN_DATA-Objekt an Plug-Ins übergeben wird. Die folgenden sind Werte gültig:

  • Text: Eingehende XML-Daten sind in einer WSMAN_DATA_TYPE_TEXT-Struktur enthalten, die xml als PCWSTR-Speicherpuffer darstellt.
  • XMLReader: Eingehende XML-Daten sind in einer WSMAN_DATA_TYPE_WS_XML_READER-Struktur enthalten, die das XML als XmlReader-Objekt darstellt, das in der Headerdatei "WebServices.h" definiert ist.

Unterstützte Cmdlets

Verwenden der Pipeline

Anbieter-Cmdlets akzeptieren Pipelineeingaben. Sie können die Pipeline verwenden, um die Aufgabe zu vereinfachen, indem Sie Anbieterdaten von einem Cmdlet an ein anderes Anbieter-Cmdlet senden. Weitere Informationen zur Verwendung der Pipeline mit Anbieter-Cmdlets finden Sie in den Cmdlet-Verweisen in diesem Artikel.

Hilfe

Ab Windows PowerShell 3.0 können Sie benutzerdefinierte Hilfethemen für Anbieter-Cmdlets abrufen, die erläutern, wie sich diese Cmdlets in einem Dateisystemlaufwerk verhalten.

Um die Hilfethemen abzurufen, die für das Dateisystemlaufwerk angepasst sind, führen Sie einen Get-Help-Befehl in einem Dateisystemlaufwerk aus, oder verwenden Sie den -Path Parameter von Get-Help , um ein Dateisystemlaufwerk anzugeben.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path wsman:

Weitere Informationen