about_WSMan_Provider

  • Artykuł

Nazwa dostawcy

Wsman

Dyski

WSMan:

Krótki opis

Zapewnia dostęp do informacji o konfiguracji usług sieci Web na potrzeby zarządzania (WS-Management).

Szczegółowy opis

Dostawca programu WSMan dla programu PowerShell umożliwia dodawanie, zmienianie, czyszczenie i usuwanie danych konfiguracji programu WS-Management na komputerach lokalnych lub zdalnych.

Dostawca WSMan uwidacznia dysk programu PowerShell ze strukturą katalogów odpowiadającą logicznemu grupowaniu ustawień konfiguracji usługi WS-Management. Te grupy są nazywane kontenerami.

Począwszy od programu Windows PowerShell 3.0, dostawca WSMan został zaktualizowany w celu obsługi nowych właściwości konfiguracji sesji, takich jak OutputBufferingMode. Konfiguracje sesji są wyświetlane jako elementy w katalogu WSMan: Plugin dysku, a właściwości są wyświetlane jako elementy w każdej konfiguracji sesji.

Dostawca WSMan obsługuje następujące polecenia cmdlet, które zostały omówione w tym artykule.

Uwaga

Polecenia na WSMan: dysku umożliwiają zmianę wartości nowych właściwości. Nie można jednak użyć WSMan: dysku w programie PowerShell 2.0, aby zmienić właściwości wprowadzone w programie Windows PowerShell 3.0. Mimo że nie jest generowany żaden błąd, polecenia nie są skuteczne Aby zmienić te ustawienia, użyj dysku WSMan w programie Windows PowerShell 3.0.

Organizacja programu WSMan: drive

  • Klient: Można skonfigurować różne aspekty klienta zarządzania usługami WS. Informacje o konfiguracji są przechowywane w rejestrze.

  • Usługa: można skonfigurować różne aspekty usługi WS-Management. Informacje o konfiguracji są przechowywane w rejestrze.

    Uwaga

    Konfiguracja usługi jest czasami nazywana konfiguracją serwera.

  • Powłoka: Można skonfigurować różne aspekty powłoki zarządzania usługami WS, takie jak ustawienie zezwalające na dostęp do powłoki zdalnej (AllowRemoteShellAccess) i maksymalną dozwoloną liczbę współbieżnych użytkowników (MaxConcurrentUsers).

  • Odbiornik: możesz utworzyć i skonfigurować odbiornik. Odbiornik to usługa zarządzania, która implementuje protokół WS-Management do wysyłania i odbierania komunikatów.

  • Wtyczka: wtyczki są ładowane i używane przez usługę WS-Management w celu zapewnienia różnych funkcji. Domyślnie program PowerShell udostępnia trzy wtyczki:

    • Wtyczka przekazywania zdarzeń.
    • Wtyczka Microsoft.PowerShell.
    • Wtyczka dostawcy instrumentacji zarządzania Windows (WMI). Te trzy wtyczki obsługują przekazywanie zdarzeń, konfigurację i dostęp do usługi WMI.

  • ClientCertificate: można utworzyć i skonfigurować certyfikat klienta. Certyfikat klienta jest używany, gdy klient zarządzania usługami WS jest skonfigurowany do używania uwierzytelniania certyfikatu.

Hierarchia katalogów dostawcy programu WSMan

Hierarchia katalogów dostawcy WSMan dla komputera lokalnego jest następująca.

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

Hierarchia katalogów dostawcy programu WSMan dla komputera zdalnego jest taka sama jak komputer lokalny. Aby jednak uzyskać dostęp do ustawień konfiguracji komputera zdalnego, należy nawiązać połączenie z komputerem zdalnym przy użyciu Połączenie-WSMan. Po nawiązaniu połączenia z komputerem zdalnym nazwa komputera zdalnego jest wyświetlana w dostawcy.

WSMan:\<Remote_Computer_Name>

To polecenie używa Set-Location polecenia cmdlet , aby zmienić bieżącą lokalizację na WSMan: dysk.

Set-Location WSMan:

Aby powrócić do dysku systemu plików, wpisz nazwę dysku. Na przykład wpisz.

Set-Location C:

To polecenie używa Set-Location polecenia , aby zmienić bieżącą lokalizację na lokalizację główną w lokalizacji zdalnego magazynu systemu. Użyj ukośnika \ odwrotnego lub ukośnika / do przodu, aby wskazać poziom WSMan: dysku.

Set-Location -Path  WSMan:\SERVER01

Uwaga

Powyższe polecenie zakłada, że istnieje już połączenie z systemem zdalnym.

Wyświetlanie zawartości narzędzia WSMan: drive

To polecenie używa Get-Childitem polecenia cmdlet do wyświetlania magazynów WS-Management w lokalizacji magazynu Localhost.

Get-ChildItem -path WSMan:\Localhost

Jeśli jesteś na WSMan: dysku, możesz pominąć nazwę dysku.

To polecenie używa Get-Childitem polecenia cmdlet do wyświetlania magazynów WS-Management na komputerze zdalnym "SERVER01" lokalizacji magazynu.

Get-ChildItem -path WSMan:\SERVER01

Uwaga

Powyższe polecenie zakłada, że istnieje już połączenie z systemem zdalnym.

Ustawianie wartości elementów w programie WSMAN: drive

Możesz użyć Set-Item polecenia cmdlet , aby zmienić ustawienia konfiguracji na WSMAN dysku. Poniższy przykład ustawia wartość TrustedHosts na akceptowanie wszystkich hostów z sufiksem "contoso.com".

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

Polecenie Set-Item cmdlet obsługuje dodatkowy parametr -Concatenate , który dołącza wartość zamiast go zmieniać. Poniższy przykład spowoduje dołączenie nowej wartości "*.domain2.com" do starej wartości przechowywanej w TrustedHost:

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

Tworzenie elementów w programie WSMAN: dysk

Tworzenie nowego odbiornika

Polecenie New-Item cmdlet tworzy elementy na dysku dostawcy. Każdy dostawca ma różne typy elementów, które można utworzyć. Na WSMAN: dysku można utworzyć odbiorniki , które można skonfigurować do odbierania i odpowiadania na żądania zdalne. Następujące polecenie tworzy nowy odbiornik HTTP przy użyciu New-Item polecenia cmdlet .

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

Tworzenie nowej wtyczki

To polecenie tworzy (rejestruje) wtyczkę dla usługi WS-Management.

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

Tworzenie nowego wpisu zasobu

To polecenie tworzy wpis zasobu w katalogu Resources w pliku TestPlugin. To polecenie zakłada, że testPlugin został utworzony przy użyciu oddzielnego polecenia.

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

Tworzenie nowego wpisu zabezpieczeń dla zasobu

To polecenie tworzy wpis zabezpieczeń w katalogu Zabezpieczenia Resource_5967683 (określony zasób). To polecenie zakłada, że wpis zasobu został utworzony przy użyciu oddzielnego polecenia.

$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)"

Tworzenie nowego certyfikatu klienta

To polecenie tworzy wpis ClientCertificate , który może być używany przez klienta WS-Management. Nowy element ClientCertificate zostanie wyświetlony w katalogu ClientCertificate jako "ClientCertificate_1234567890". Wszystkie parametry są obowiązkowe. Wystawca musi być odciskiem palca certyfikatu wystawców.

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

Tworzenie nowego parametru inicjowania

To polecenie tworzy parametr inicjowania o nazwie "testparametername" w katalogu "InitializationParameters". To polecenie zakłada, że polecenie "TestPlugin" zostało utworzone przy użyciu oddzielnego polecenia.

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

Parametry dynamiczne

Parametry dynamiczne to parametry poleceń cmdlet, które są dodawane przez dostawcę programu PowerShell i są dostępne tylko wtedy, gdy polecenie cmdlet jest używane na dysku obsługującym dostawcę.

Ciąg adresu <>

Określa adres, dla którego utworzono ten odbiornik. Może to być jedna z następujących wartości:

  • Ciąg literału "*". (Symbol wieloznaczny (*) powoduje powiązanie wszystkich adresów IP we wszystkich kartach sieciowych.
  • Ciąg literału "IP:", po którym następuje prawidłowy adres IP w formacie IPv4 kropkowanym-dziesiętnym lub w formacie IPv6 cloned-szesnastkowym.
  • Ciąg literału "MAC:", po którym następuje adres MAC karty. Na przykład: MAC:32-a3-58-90-be-cc.

Uwaga

Wartość Adres jest ustawiana podczas tworzenia odbiornika.

Obsługiwane polecenia cmdlet

Wyliczenie możliwości <>

Podczas pracy z wtyczkami ten parametr określa operację obsługiwaną w tym identyfikatorze URI (Uniform Resource Identifier). Musisz utworzyć jeden wpis dla każdego typu operacji obsługiwanej przez identyfikator URI. Można określić wszystkie prawidłowe atrybuty dla danej operacji, jeśli operacja ją obsługuje.

Te atrybuty to SupportsFiltering i SupportsFragment.

  • Tworzenie: operacje tworzenia są obsługiwane w identyfikatorze URI.
    • Atrybut SupportFragment jest używany, jeśli operacja Tworzenia obsługuje koncepcję.
    • Atrybut SupportFiltering jest nieprawidłowy dla operacji tworzenia i powinien być ustawiony na wartość "Fałsz".

    Uwaga

    Ta operacja jest nieprawidłowa dla identyfikatora URI, jeśli operacje powłoki są również obsługiwane.

  • Usuń: operacje usuwania są obsługiwane w identyfikatorze URI.
    • Atrybut SupportFragment jest używany, jeśli operacja Usuwania obsługuje koncepcję.
    • Atrybut SupportFiltering jest nieprawidłowy dla operacji usuwania i powinien być ustawiony na wartość "Fałsz".

    Uwaga

    Ta operacja jest nieprawidłowa dla identyfikatora URI, jeśli operacje powłoki są również obsługiwane.

  • Wyliczenie: operacje wyliczania są obsługiwane w identyfikatorze URI.
    • Atrybut SupportFragment nie jest obsługiwany w przypadku operacji wyliczania i powinien być ustawiony na wartość False.
    • Atrybut SupportFiltering jest prawidłowy, a jeśli wtyczka obsługuje filtrowanie, ten atrybut powinien być ustawiony na wartość "True".

    Uwaga

    Ta operacja jest nieprawidłowa dla identyfikatora URI, jeśli operacje powłoki są również obsługiwane.

  • Pobierz: operacje pobierania są obsługiwane w identyfikatorze URI.
    • Atrybut SupportFragment jest używany, jeśli operacja Get obsługuje koncepcję.
    • Atrybut SupportFiltering jest nieprawidłowy dla operacji Pobierania i powinien być ustawiony na wartość "Fałsz".

    Uwaga

    Ta operacja jest nieprawidłowa dla identyfikatora URI, jeśli operacje powłoki są również obsługiwane.

  • Wywołaj: operacje wywołania są obsługiwane w identyfikatorze URI.
    • Atrybut SupportFragment nie jest obsługiwany dla operacji Invoke i powinien być ustawiony na wartość False.
    • Atrybut SupportFiltering jest nieprawidłowy i powinien być ustawiony na wartość "Fałsz".

    Uwaga

    Ta operacja jest nieprawidłowa dla identyfikatora URI, jeśli operacje powłoki są również obsługiwane.

  • Put: Operacje umieszczania są obsługiwane w identyfikatorze URI.
    • Atrybut SupportFragment jest używany, jeśli operacja Put obsługuje koncepcję.
    • Atrybut SupportFiltering jest nieprawidłowy dla operacji Put i powinien być ustawiony na wartość "False".

    Uwaga

    Ta operacja jest nieprawidłowa dla identyfikatora URI, jeśli operacje powłoki są również obsługiwane.

  • Subskrybuj: operacje subskrypcji są obsługiwane w identyfikatorze URI.
    • Atrybut SupportFragment nie jest obsługiwany dla operacji subskrybuj i powinien być ustawiony na wartość False.
    • Atrybut SupportFiltering jest nieprawidłowy dla operacji subskrybuj i powinien być ustawiony na wartość "Fałsz".

    Uwaga

    Ta operacja jest nieprawidłowa dla identyfikatora URI, jeśli operacje powłoki są również obsługiwane.

  • Powłoka: operacje powłoki są obsługiwane w identyfikatorze URI.
    • Atrybut SupportFragment nie jest obsługiwany dla operacji powłoki i powinien być ustawiony na wartość "Fałsz".
    • Atrybut SupportFiltering jest nieprawidłowy dla operacji powłoki i powinien być ustawiony na wartość "Fałsz".

    Uwaga

    Ta operacja jest nieprawidłowa dla identyfikatora URI, jeśli jest również obsługiwana inna operacja.

    Uwaga

    Jeśli operacja powłoki jest skonfigurowana dla identyfikatora URI, Get, Put, Create, Delete, Invoke i Enumerate są przetwarzane wewnętrznie w usłudze WS-Management (WinRM) do zarządzania powłokami. W związku z tym wtyczka nie może obsłużyć operacji.

Obsługiwane polecenia cmdlet

CertificateThumbprint <String>

Określa odcisk palca certyfikatu usługi.

Ta wartość reprezentuje ciąg dwucyfrowych wartości szesnastkowych w polu Odcisk palca certyfikatu. Określa certyfikat cyfrowego klucza publicznego (X509) konta użytkownika, które ma uprawnienia do wykonania tej akcji. Certyfikaty są używane w uwierzytelnianiu opartym na certyfikatach klienta. Mogą być mapowane tylko na konta użytkowników lokalnych i nie działają z kontami domeny. Aby uzyskać odcisk palca certyfikatu, użyj Get-Item poleceń cmdlet lub Get-ChildItem na dysku programu PowerShell Cert: .

Obsługiwane polecenia cmdlet

Włączono <wartość logiczną>

Określa, czy odbiornik jest włączony, czy wyłączony. Wartość domyślna to True.

Obsługiwane polecenia cmdlet

Ciąg FileName (Plugin) <>

Określa nazwę pliku wtyczki operacji. Wszystkie zmienne środowiskowe wprowadzone w tym wpisie zostaną rozwinięte w kontekście użytkowników po odebraniu żądania. Ponieważ każdy użytkownik może mieć inną wersję tej samej zmiennej środowiskowej, każdy użytkownik może mieć inną wtyczkę. Ten wpis nie może być pusty i musi wskazywać prawidłową wtyczkę.

Obsługiwane polecenia cmdlet

Ciąg nazwy <hosta>

Określa nazwę hosta komputera, na którym jest uruchomiona usługa WS-Management (WinRM).

Wartość musi być w pełni kwalifikowaną nazwą domeny, ciągiem literału IPv4 lub IPv6 albo symbolem wieloznacznymi.

Obsługiwane polecenia cmdlet

Ciąg wystawcy <>

Określa nazwę urzędu certyfikacji, który wystawił certyfikat.

Obsługiwane polecenia cmdlet

Wtyczki <> WS-Management to natywne biblioteki linków dynamicznych (DLL)

to podłączanie i rozszerzanie funkcjonalności usługi WS-Management . Interfejs API wtyczek WSW-Management udostępnia funkcje, które umożliwiają użytkownikowi zapisywanie wtyczek przez zaimplementowanie niektórych interfejsów API dla obsługiwanych identyfikatorów URI zasobów i operacji. Po skonfigurowaniu wtyczek dla usługi WS-Management (WinRM) lub usług Internet Information Services (IIS) wtyczka jest ładowana na hoście zarządzania usługami WS-Management lub na hoście usług IIS. Żądania zdalne są kierowane do tych punktów wejścia wtyczki w celu wykonywania operacji.

Obsługiwane polecenia cmdlet

Port <bez znaku — krótka liczba całkowita>

Określa port TCP, dla którego jest tworzony ten odbiornik. Można określić dowolną wartość z zakresu od 1 do 65535.

Obsługiwane polecenia cmdlet

Ciąg zasobu <>

Określa punkt końcowy reprezentujący odrębny typ operacji lub wartości zarządzania. Usługa uwidacznia co najmniej jeden zasób, a niektóre zasoby mogą mieć więcej niż jedno wystąpienie. Zasób zarządzania jest podobny do klasy WMI lub tabeli bazy danych, a wystąpienie jest podobne do wystąpienia klasy lub wiersza w tabeli. Na przykład klasa Win32_LogicalDisk reprezentuje zasób. Win32_LogicalDisk="C:\\" jest konkretnym wystąpieniem zasobu.

Identyfikator URI (Uniform Resource Identifier) zawiera prefiks i ścieżkę do zasobu. Na przykład:

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

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

Obsługiwane polecenia cmdlet

Ciąg zasobu <>

Określa identyfikator URI (Uniform Resource Identifier), który identyfikuje określony typ zasobu, taki jak dysk lub proces, na komputerze.

Identyfikator URI składa się z prefiksu i ścieżki do zasobu. Na przykład:

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

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

Obsługiwane polecenia cmdlet

Ciąg SDKVersion <>

Określa wersję zestawu SDK wtyczki WS-Management. Jedyną prawidłową wartością jest 1.

Obsługiwane polecenia cmdlet

Ciąg tematu <>

Określa jednostkę, która jest identyfikowana przez certyfikat.

Obsługiwane polecenia cmdlet

Ciąg transportu <>

Określa transport używany do wysyłania i odbierania żądań i odpowiedzi protokołu WS-Management. Wartość musi mieć wartość HTTP lub HTTPS.

Uwaga: wartość Transport jest ustawiana podczas tworzenia odbiornika.

Obsługiwane polecenia cmdlet

Ciąg identyfikatora URI <>

Określa identyfikator URI, dla którego dostęp jest autoryzowany na podstawie wartości parametru Sddl.

Obsługiwane polecenia cmdlet

Ciąg urlPrefix <>

Prefiks adresu URL, na którym mają być akceptowane żądania HTTP lub HTTPS. Jest to ciąg zawierający tylko znaki [a-z], , [A-Z], [9-0]podkreślenie (_) i ukośnik odwrotny (/). Ciąg nie może zaczynać się od lub kończyć ukośnikiem odwrotnym (/). Jeśli na przykład nazwa komputera to "SampleComputer", klient zarządzania WS-Management określi http://SampleMachine/URLPrefix adres docelowy.

Obsługiwane polecenia cmdlet

Ciąg wartości <>

Określa wartość parametru inicjowania, który jest wartością specyficzną dla wtyczki, która służy do określania opcji konfiguracji.

Obsługiwane polecenia cmdlet

Ciąg XMLRenderingType <>

Określa format, w którym kod XML jest przekazywany do wtyczek za pośrednictwem obiektu WSMAN_DATA . Poniżej przedstawiono prawidłowe wartości:

  • Tekst: Przychodzące dane XML znajdują się w strukturze WSMAN_DATA_TYPE_TEXT , która reprezentuje kod XML jako bufor pamięci PCWSTR .
  • XMLReader: przychodzące dane XML znajdują się w strukturze WSMAN_DATA_TYPE_WS_XML_READER , która reprezentuje kod XML jako obiekt XmlReader , który jest zdefiniowany w pliku nagłówka "WebServices.h".

Obsługiwane polecenia cmdlet

Korzystanie z potoku

Polecenia cmdlet dostawcy akceptują dane wejściowe potoku. Potok umożliwia uproszczenie zadania, wysyłając dane dostawcy z jednego polecenia cmdlet do innego dostawcy. Aby dowiedzieć się więcej na temat używania potoku z poleceniami cmdlet dostawcy, zobacz odwołania do poleceń cmdlet podanych w tym artykule.

Uzyskiwanie pomocy

Począwszy od programu Windows PowerShell 3.0, możesz uzyskać dostosowane tematy pomocy dla poleceń cmdlet dostawcy, które wyjaśniają, jak te polecenia cmdlet zachowują się na dysku systemu plików.

Aby uzyskać tematy pomocy dostosowane dla dysku systemu plików, uruchom polecenie Get-Help na dysku systemu plików lub użyj -Path parametru Get-Help , aby określić dysk systemu plików.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path wsman:

Zobacz też