Get-WSManInstance

Odwołanie

Moduł:: Microsoft.WSMan.Management

Wyświetla informacje o zarządzaniu dla wystąpienia zasobu określonego przez identyfikator URI zasobu.

Składnia

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

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

Opis

Polecenie Get-WSManInstance cmdlet pobiera wystąpienie zasobu zarządzania określonego przez identyfikator URI (Uniform Resource Identifier). Pobrane informacje mogą być złożonym zestawem informacji XML, który jest obiektem lub prostą wartością. To polecenie cmdlet jest odpowiednikiem standardowego polecenia Web Services for Management (WS-Management).

To polecenie cmdlet używa warstwy połączenia/transportu WS-Management do pobierania informacji.

Przykłady

Przykład 1. Pobieranie wszystkich informacji z usługi WMI

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

To polecenie zwraca wszystkie informacje udostępniane przez instrumentację zarządzania Windows (WMI) dotyczące usługi WinRM na komputerze zdalnym server01.

Przykład 2. Pobieranie stanu usługi buforowania

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

To polecenie zwraca tylko stan usługi buforowania na komputerze zdalnym server01.

Przykład 3. Pobieranie odwołań do punktów końcowych dla wszystkich usług

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

To polecenie zwraca odwołania do punktów końcowych, które odpowiadają wszystkim usługom na komputerze lokalnym.

Przykład 4. Pobieranie usług spełniających określone kryteria

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

To polecenie wyświetla listę wszystkich usług spełniających następujące kryteria na zdalnym komputerze Server01:

Typ uruchamiania usługi to Automatyczny.
Usługa została zatrzymana.

Przykład 5. Pobieranie konfiguracji odbiornika spełniającego kryteria na komputerze lokalnym

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

To polecenie wyświetla listę konfiguracji odbiornika WS-Management na komputerze lokalnym dla odbiornika, który spełnia kryteria w zestawie selektora.

Przykład 6. Pobieranie konfiguracji odbiornika spełniającego kryteria na komputerze zdalnym

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

To polecenie wyświetla konfigurację odbiornika WS-Management na komputerze zdalnym server01 dla odbiornika, który spełnia kryteria w zestawie selektora.

Przykład 7. Pobieranie skojarzonych wystąpień powiązanych z określonym wystąpieniem

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

To polecenie pobiera skojarzone wystąpienia powiązane z określonym wystąpieniem (winrm).

Należy ująć filtr w cudzysłów, jak pokazano w przykładzie.

Przykład 8. Pobieranie wystąpień skojarzeń powiązanych z określonym wystąpieniem

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

To polecenie pobiera wystąpienia skojarzeń powiązane z określonym wystąpieniem (winrm). Ponieważ wartość dialektu jest skojarzeniem, a parametr Skojarzenia jest używany, to polecenie zwraca wystąpienia skojarzeń, a nie skojarzone wystąpienia.

Należy ująć filtr w cudzysłów, jak pokazano w przykładzie.

Parametry

-ApplicationName

Określa nazwę aplikacji w połączeniu. Wartość domyślna parametru ApplicationName to WSMAN. Pełny identyfikator zdalnego punktu końcowego ma następujący format:

Na przykład: http://server01:8080/WSMAN.

Internet Information Services (IIS), który hostuje sesję, przekazuje żądania z tym punktem końcowym do określonej aplikacji. To ustawienie domyślne programu WSMAN jest odpowiednie dla większości zastosowań. Ten parametr jest przeznaczony do użycia, jeśli wiele komputerów nawiązuje połączenia zdalne z jednym komputerem z uruchomionym programem PowerShell. W takim przypadku usługi IIS hostuje usługę WS-Management pod kątem wydajności.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Associations

Wskazuje, że to polecenie cmdlet pobiera wystąpienia skojarzeń, a nie skojarzone wystąpienia. Tego parametru można użyć tylko wtedy, gdy parametr dialektu ma wartość Skojarzenie.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Authentication

Określa mechanizm uwierzytelniania, który ma być używany na serwerze. Dopuszczalne wartości tego parametru to:

Basic - Podstawowa to schemat, w którym nazwa użytkownika i hasło są wysyłane w postaci zwykłego tekstu do serwera lub serwera proxy.
Default — Użyj metody uwierzytelniania zaimplementowanej przez protokół WS-Management. Jest to opcja domyślna.
Digest — Skrót to schemat odpowiedzi wyzwania, który używa ciągu danych określonego przez serwer do wyzwania.
Kerberos — Komputer kliencki i serwer wzajemnie się uwierzytelniają przy użyciu certyfikatów Protokołu Kerberos.
Negotiate - Negocjacja to schemat odpowiedzi na żądanie, który negocjuje z serwerem lub serwerem proxy w celu określenia schematu do użycia do uwierzytelniania. Na przykład ta wartość parametru umożliwia negocjowanie w celu określenia, czy jest używany protokół Kerberos, czy NTLM.
CredSSP — Użyj uwierzytelniania dostawcy obsługi zabezpieczeń poświadczeń (CredSSP), które umożliwia użytkownikowi delegowanie poświadczeń. Ta opcja jest przeznaczona dla poleceń uruchamianych na jednym komputerze zdalnym, ale zbierać dane z lub uruchamiać dodatkowe polecenia na innych komputerach zdalnych.

Uwaga

Dostawca CredSSP deleguje poświadczenia użytkownika z komputera lokalnego do komputera zdalnego. Ta praktyka zwiększa ryzyko bezpieczeństwa operacji zdalnej. W przypadku naruszenia zabezpieczeń komputera zdalnego po przekazaniu do niego poświadczeń można użyć poświadczeń do kontrolowania sesji sieciowej.

Type:	AuthenticationMechanism
Aliases:	auth, am
Accepted values:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BasePropertiesOnly

Wskazuje, że to polecenie cmdlet wylicza tylko właściwości, które są częścią klasy bazowej określonej przez parametr ResourceURI . Ten parametr nie ma wpływu, jeśli określono parametr Płytkie .

Type:	SwitchParameter
Aliases:	UBPO, Base
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Określa cyfrowy certyfikat klucza publicznego (X509) konta użytkownika, które ma uprawnienia do wykonania tej akcji. Wprowadź odcisk palca certyfikatu.

Certyfikaty są używane w uwierzytelnianiu opartym na certyfikatach klienta. Mogą być mapowane tylko na konta użytkowników lokalnych; nie działają z kontami domeny.

Aby uzyskać odcisk palca certyfikatu, użyj Get-Item polecenia lub Get-ChildItem w dysku Certyfikat programu PowerShell.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

Określa komputer, na którym ma zostać uruchomiona operacja zarządzania. Wartość może być w pełni kwalifikowaną nazwą domeny, nazwą NetBIOS lub adresem IP. Użyj nazwy komputera lokalnego, użyj hosta lokalnego lub użyj kropki (.), aby określić komputer lokalny. Komputer lokalny jest domyślny. Jeśli komputer zdalny znajduje się w innej domenie niż użytkownik, należy użyć w pełni kwalifikowanej nazwy domeny. Do polecenia cmdlet można przekazać wartość tego parametru.

Type:	String
Aliases:	CN
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionURI

Określa punkt końcowy połączenia. Format tego ciągu jest następujący:

Następujący ciąg jest poprawnie sformatowaną wartością dla tego parametru:

http://Server01:8080/WSMAN

Identyfikator URI musi być w pełni kwalifikowany.

Type:	Uri
Aliases:	CURI, CU
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Określa konto użytkownika, które ma uprawnienia do wykonania tej akcji. Wartość domyślna to użytkownik bieżący. Wpisz nazwę użytkownika, taką jak User01, Domain01\User01 lub User@Domain.com. Możesz też wprowadzić obiekt PSCredential , taki jak obiekt zwrócony przez Get-Credential polecenie cmdlet. Po wpiseniu nazwy użytkownika to polecenie cmdlet wyświetli monit o podanie hasła.

Type:	PSCredential
Aliases:	cred, c
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Dialect

Określa dialekt do użycia w predykacie filtru. Może to być każdy dialekt obsługiwany przez usługę zdalną. Dla identyfikatora URI dialektu można użyć następujących aliasów:

WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
Selektor- http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
Stowarzyszenia- http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Enumerate

Wskazuje, że to polecenie cmdlet zwraca wszystkie wystąpienia zasobu zarządzania.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

Określa wyrażenie filtru dla wyliczenia. Jeśli określisz ten parametr, musisz również określić dialekt.

Prawidłowe wartości tego parametru zależą od dialektu określonego w dialektze. Jeśli na przykład dialekt to WQL, parametr Filter musi zawierać ciąg, a ciąg musi zawierać prawidłowe zapytanie WQL, takie jak następujące zapytanie:

"Select * from Win32_Service where State != Running"

Jeśli dialekt jest skojarzeniem, filtr musi zawierać ciąg, a ciąg musi zawierać prawidłowy filtr, taki jak następujący filtr:

-filter:Object=EPR\[;AssociationClassName=AssocClassName\]\[;ResultClassName=ClassName\]\[;Role=RefPropertyName\]\[;ResultRole=RefPropertyName\]}

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Fragment

Określa sekcję wewnątrz wystąpienia, które ma zostać zaktualizowane lub pobrane dla określonej operacji. Aby na przykład uzyskać stan usługi buforowania, określ następujące elementy:

-Fragment Status

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OptionSet

Określa zestaw przełączników do usługi w celu zmodyfikowania lub uściślinia charakteru żądania. Te przełączniki przypominają przełączniki używane w powłokach wiersza polecenia, ponieważ są one specyficzne dla usługi. Można określić dowolną liczbę opcji.

W poniższym przykładzie pokazano składnię przekazującą wartości 1, 2 i 3 dla parametrów a, b i c:

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

Type:	Hashtable
Aliases:	OS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Port

Określa port, który ma być używany, gdy klient nawiązuje połączenie z usługą WinRM. Gdy transport to HTTP, domyślny port to 80. Gdy transport to HTTPS, domyślny port to 443.

W przypadku używania protokołu HTTPS jako transportu wartość parametru ComputerName musi być zgodna z nazwą pospolitą certyfikatu serwera (CN). Jeśli jednak parametr SkipCNCheck jest określony jako część parametru SessionOption , nazwa pospolita certyfikatu serwera nie musi być zgodna z nazwą hosta serwera. Parametr SkipCNCheck powinien być używany tylko dla zaufanych komputerów.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceURI

Określa identyfikator URI klasy zasobów lub wystąpienia. Identyfikator URI identyfikuje określony typ zasobu, taki jak dyski lub procesy, na komputerze.

Identyfikator URI składa się z prefiksu i ścieżki 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

Type:	Uri
Aliases:	RURI
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReturnType

Określa typ danych do zwrócenia. Dopuszczalne wartości tego parametru to:

Object
EPR
ObjectAndEPR

Domyślna wartość to Object.

Jeśli określisz Object lub nie określisz tego parametru, to polecenie cmdlet zwróci tylko obiekty. Jeśli określisz odwołanie do punktu końcowego (EPR), to polecenie cmdlet zwróci tylko odwołania do punktu końcowego obiektów. Odwołania do punktu końcowego zawierają informacje o identyfikatorze URI zasobu i selektorach dla wystąpienia. Jeśli określisz ObjectAndEPRwartość , to polecenie cmdlet zwróci zarówno obiekt, jak i skojarzone odwołania do jego punktu końcowego.

Type:	String
Aliases:	RT
Accepted values:	object, epr, objectandepr
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SelectorSet

Określa zestaw par wartości używanych do wybierania określonych wystąpień zasobów zarządzania. Parametr SelectorSet jest używany, gdy istnieje więcej niż jedno wystąpienie zasobu. Wartość parametru SelectorSet musi być tabelą skrótów.

W poniższym przykładzie pokazano, jak wprowadzić wartość dla tego parametru:

-SelectorSet @{Name="WinRM";ID="yyy"}

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SessionOption

Określa opcje rozszerzone dla sesji WS-Management. Wprowadź obiekt SessionOption utworzony przy użyciu polecenia cmdlet New-WSManSessionOption. Aby uzyskać więcej informacji na temat dostępnych opcji, wpisz Get-Help New-WSManSessionOption.

Type:	SessionOption
Aliases:	SO
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Shallow

Wskazuje, że to polecenie cmdlet zwraca tylko wystąpienia klasy bazowej określonej w identyfikatorze URI zasobu. Jeśli nie określisz tego parametru, to polecenie cmdlet zwraca wystąpienia klasy bazowej określonej w identyfikatorze URI i we wszystkich klasach pochodnych.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSSL

Określa, że protokół Secure Sockets Layer (SSL) jest używany do nawiązywania połączenia z komputerem zdalnym. Domyślnie nie jest używane szyfrowanie SSL.

Usługa WS-Management szyfruje całą zawartość programu Windows PowerShell przesyłaną przez sieć. Parametr UseSSL umożliwia określenie dodatkowej ochrony protokołu HTTPS zamiast protokołu HTTP. Jeśli protokół SSL nie jest dostępny na porcie używanym na potrzeby połączenia i określisz ten parametr, polecenie zakończy się niepowodzeniem.

Type:	SwitchParameter
Aliases:	SSL
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

XmlElement

To polecenie cmdlet zwraca obiekt XMLElement .

Get-WSManInstance

Składnia

Opis

Przykłady

Przykład 1. Pobieranie wszystkich informacji z usługi WMI

Przykład 2. Pobieranie stanu usługi buforowania

Przykład 3. Pobieranie odwołań do punktów końcowych dla wszystkich usług

Przykład 4. Pobieranie usług spełniających określone kryteria

Przykład 5. Pobieranie konfiguracji odbiornika spełniającego kryteria na komputerze lokalnym

Przykład 6. Pobieranie konfiguracji odbiornika spełniającego kryteria na komputerze zdalnym

Przykład 7. Pobieranie skojarzonych wystąpień powiązanych z określonym wystąpieniem

Przykład 8. Pobieranie wystąpień skojarzeń powiązanych z określonym wystąpieniem

Parametry

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Dane wejściowe

Dane wyjściowe

Opinia

Dodatkowe zasoby

Get-WSManInstance

Składnia

Opis

Przykłady

Przykład 1. Pobieranie wszystkich informacji z usługi WMI

Przykład 2. Pobieranie stanu usługi buforowania

Przykład 3. Pobieranie odwołań do punktów końcowych dla wszystkich usług

Przykład 4. Pobieranie usług spełniających określone kryteria

Przykład 5. Pobieranie konfiguracji odbiornika spełniającego kryteria na komputerze lokalnym

Przykład 6. Pobieranie konfiguracji odbiornika spełniającego kryteria na komputerze zdalnym

Przykład 7. Pobieranie skojarzonych wystąpień powiązanych z określonym wystąpieniem

Przykład 8. Pobieranie wystąpień skojarzeń powiązanych z określonym wystąpieniem

Parametry

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Dane wejściowe

Dane wyjściowe

Linki powiązane

Opinia

Dodatkowe zasoby