Dostawca programu WSMan
Nazwa dostawcy
Wsman
Napędy
WSMan:
Krótki opis
Zapewnia dostęp do informacji o konfiguracji usług sieci Web do zarządzania (WS-Management).
Szczegółowy opis
Dostawca programu WSMan dla programu PowerShell umożliwia dodawanie, zmienianie, czyszczenie i usuwanie danych konfiguracji WS-Management na komputerach lokalnych lub zdalnych.
Dostawca WSMan uwidacznia dysk programu PowerShell ze strukturą katalogów odpowiadającą logicznemu grupowaniu ustawień konfiguracji WS-Management. Te grupowania 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
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 Windows PowerShell 3.0.
Mimo że nie jest generowany błąd, polecenia nie są skuteczne Aby zmienić te ustawienia, użyj dysku WSMan w Windows PowerShell 3.0.
Organizacja programu WSMan: dysk
Klient: można skonfigurować różne aspekty klienta WS-Management. 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 WS-Management, takie jak ustawienie zezwalające na dostęp do powłoki zdalnej (AllowRemoteShellAccess) i maksymalną liczbę współbieżnych użytkowników dozwolonych (MaxConcurrentUsers).
Odbiornik: można 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żesz 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 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 programu Connect-WSMan. Po nawiązaniu połączenia z komputerem zdalnym nazwa komputera zdalnego jest wyświetlana u dostawcy.
WSMan:\<Remote_Computer_Name>
Nawigowanie po programie WSMan: dysk
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:
Przechodzenie do lokalizacji zdalnego magazynu systemu
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 połączenie z systemem zdalnym już istnieje.
Wyświetlanie zawartości programu 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 połączenie z systemem zdalnym już istnieje.
Ustawianie wartości elementów w programie WSMAN: dysk
Możesz użyć polecenia cmdlet , Set-Item 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 dołączy 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, które można skonfigurować pod kątem 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 pliku TestPlugin. W tym poleceniu przyjęto założenie, że plik 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 zabezpieczeń 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-hexadecimal.
- 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ść Address (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ą dla tego identyfikatora URI( Uniform Resource Identifier). Musisz utworzyć jeden wpis dla każdego typu operacji obsługiwanej przez identyfikator URI. Można określić dowolne 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 tę 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 obsługiwane są również operacje powłoki.
- Usuwanie: 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 obsługiwane są również operacje powłoki.
- 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 obsługiwane są również operacje powłoki.
- Pobieranie: 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ść "Fałsz".
Uwaga
Ta operacja jest nieprawidłowa dla identyfikatora URI, jeśli obsługiwane są również operacje powłoki.
- Wywołaj: operacje wywoływania 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 obsługiwane są również operacje powłoki.
- Umieść: 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ść "Fałsz".
Uwaga
Ta operacja jest nieprawidłowa dla identyfikatora URI, jeśli obsługiwane są również operacje powłoki.
- Subskrybuj: operacje subskrypcji są obsługiwane w identyfikatorze URI.
- Atrybut SupportFragment nie jest obsługiwany dla operacji subskrybowania i powinien być ustawiony na wartość False.
- Atrybut SupportFiltering jest nieprawidłowy dla operacji subskrybowania i powinien być ustawiony na wartość "Fałsz".
Uwaga
Ta operacja jest nieprawidłowa dla identyfikatora URI, jeśli obsługiwane są również operacje powłoki.
- 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, Twórca, 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
Ciąg certificateThumbprint <>
Określa odcisk palca certyfikatu usługi.
Ta wartość reprezentuje ciąg dwucyfrowych wartości szesnastkowe w polu Odcisk palca certyfikatu. Określa cyfrowy certyfikat 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
Wtyczka <> WS-Management wtyczek to natywne biblioteki linków dynamicznych (DLL)
to wtyczka i rozszerzenie funkcjonalności WS-Management . Interfejs API wtyczek WSW-Management udostępnia funkcje, które umożliwiają użytkownikowi pisanie wtyczek przez zaimplementowanie niektórych interfejsów API na potrzeby 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
Przenoszenie <niepodpisanej krótkiej liczby całkowitej>
Określa port TCP, dla którego ten odbiornik jest tworzony. Można określić dowolną wartość z zakresu od 1 do 65535.
Obsługiwane polecenia cmdlet
Ciąg zasobu <>
Określa punkt końcowy, który reprezentuje 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:
https://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, takiego jak dysk lub proces, na komputerze.
Identyfikator URI składa się z prefiksu i ścieżki do zasobu. Na przykład:
https://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 transportowy <>
Określa transport używany do wysyłania i odbierania żądań i odpowiedzi protokołu WS-Management. Wartość musi być http lub HTTPS.
Uwaga: Wartość transportu 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 ukośnika odwrotnego (/). Jeśli na przykład nazwa komputera to "SampleComputer", klient WS-Management określi w http://SampleMachine/URLPrefix adresie docelowym.
Obsługiwane polecenia cmdlet
Ciąg wartości <>
Określa wartość parametru inicjowania, który jest wartością specyficzną dla wtyczki, która jest używana 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 przez wysyłanie danych dostawcy z jednego polecenia cmdlet do innego polecenia cmdlet dostawcy. Aby dowiedzieć się więcej o sposobie używania potoku z poleceniami cmdlet dostawcy, zobacz odwołania do poleceń cmdlet podane w tym artykule.
Uzyskiwanie pomocy
Począwszy od 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: