Udostępnij za pośrednictwem

about_WSMan_Provider

  • Artykuł

Nazwa dostawcy

Wsman

Napędy

WSMan:

Krótki opis

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

Szczegółowy opis

Te informacje dotyczą tylko programu PowerShell uruchomionego w systemie Windows.

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

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

Począwszy od 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

Możesz użyć poleceń na WSMan: dysku, aby zmienić 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 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 Windows PowerShell 3.0.

Organizacja programu WSMan: Drive

  • Klient: można skonfigurować różne aspekty klienta WS-Management. Informacje o konfiguracji są przechowywane w rejestrze.

  • Usługa: możesz 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 WS-Management, takie jak ustawienie zezwalania 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 WS-Management jest skonfigurowany do korzystania z uwierzytelniania certyfikatu.

Hierarchia katalogów dostawcy 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 WSMan dla komputera zdalnego jest taka sama jak komputer lokalny. Jednak aby uzyskać dostęp do ustawień konfiguracji komputera zdalnego, należy nawiązać połączenie z komputerem zdalnym przy użyciu connect-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: dysk

To polecenie używa Get-Childitem polecenia cmdlet do wyświetlania WS-Management magazynów 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 WS-Management magazynów na komputerze zdalnym "SERVER01".

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: dysk

Możesz użyć Set-Item polecenia cmdlet , aby zmienić ustawienia konfiguracji na WSMAN dysku. W poniższym przykładzie ustawiono wartość TrustedHosts tak, aby akceptowała wszystkie hosty 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 doda nową wartość "*.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ć. WSMAN: Na dysku można utworzyć odbiorniki skonfigurowane 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 serwera TestPlugin. W tym poleceniu przyjęto założenie, że element 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 polecenia 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 kropkowanym-dziesiętnym IPv4 lub w formacie szesnastkowym sklonowanego protokołu IPv6.
  • 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.

  • Twórca: operacje Twórca są obsługiwane w identyfikatorze URI.
    • Atrybut SupportFragment jest używany, jeśli operacja Twórca obsługuje koncepcję.
    • Atrybut SupportFiltering jest nieprawidłowy dla operacji Twórca 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 Usuń obsługuje koncepcję.
    • Atrybut SupportFiltering jest nieprawidłowy dla operacji Usuwania 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.

  • Wyliczanie: 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 Get 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.

  • Wywołanie: operacje wywołania są obsługiwane w identyfikatorze URI.
    • Atrybut SupportFragment nie jest obsługiwany w przypadku 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 w przypadku 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ść "False".

    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, Twórca, Delete, Invoke i Enumerate operacji są przetwarzane wewnętrznie w usłudze WS-Management (WinRM) do zarządzania powłokami. W rezultacie 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 z uprawnieniami do wykonywania 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. Wszelkie 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

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

ta wtyczka i rozszerzenie funkcjonalności WS-Management . Interfejs API WSW-Management Plug-in udostępnia funkcje, które umożliwiają użytkownikowi pisanie 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 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

Niepodpisane krótkie liczby całkowite portów <>

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 zarządzania lub wartości. 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 podmiotu <>

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 WS-Management żądań i odpowiedzi protokołu. Wartość musi być 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 można akceptować żądania HTTP lub HTTPS. Jest to ciąg zawierający tylko znaki [a-z], , [9-0][A-Z], 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 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 zdefiniowany w pliku nagłówkowym "WebServices.h".

Obsługiwane polecenia cmdlet

Korzystanie z potoku

Polecenia cmdlet dostawcy akceptują dane wejściowe potoku. Potok pozwala uprościć zadanie, 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 dokumentację poleceń cmdlet podanych w tym artykule.

Uzyskiwanie pomocy

Począwszy od Windows PowerShell 3.0, można 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ż