Get-WSManInstance

Reference

Modul:: Microsoft.WSMan.Management

Zobrazí informace o správě pro instanci prostředku určenou identifikátorem URI prostředku.

Syntax

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>]

Description

Rutina Get-WSManInstance načte instanci prostředku správy, který je určen identifikátorem URI (Uniform Resource Identifier). Načtené informace mohou být komplexní informační sada XML, což je objekt nebo jednoduchá hodnota. Tato rutina je ekvivalentem standardního příkazu Get pro správu webových služeb (WS-Management).

Tato rutina používá k načtení informací vrstvu připojení nebo přenosu SLUŽBY WS-Management.

Příklady

Příklad 1: Získání všech informací z rozhraní WMI

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

Tento příkaz vrátí všechny informace, které služba WMI (Windows Management Instrumentation) zveřejňuje o službě WinRM na vzdáleném počítači serveru01.

Příklad 2: Získání stavu služby zařazování

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

Tento příkaz vrátí pouze stav služby zařazování na vzdáleném počítači server01.

Příklad 3: Získání odkazů na koncové body pro všechny služby

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

Tento příkaz vrátí odkazy na koncové body, které odpovídají všem službám v místním počítači.

Příklad 4: Získání služeb, které splňují zadaná kritéria

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

Tento příkaz zobrazí seznam všech služeb, které splňují následující kritéria na vzdáleném počítači Server01:

Typ spuštění služby je Automatický.
Služba je zastavená.

Příklad 5: Získání konfigurace naslouchacího procesu, která odpovídá kritériím v místním počítači

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

Tento příkaz vypíše konfiguraci naslouchacího procesu WS-Management v místním počítači pro naslouchací proces, který odpovídá kritériím v sadě selektorů.

Příklad 6: Získání konfigurace naslouchacího procesu, která odpovídá kritériím na vzdáleném počítači

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

Tento příkaz vypíše konfiguraci naslouchacího procesu WS-Management na vzdáleném počítači serveru01 pro naslouchací proces, který odpovídá kritériím v sadě selektoru.

Příklad 7: Získání přidružených instancí souvisejících se zadanou instancí

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

Tento příkaz získá přidružené instance, které souvisejí se zadanou instancí (winrm).

Filtr musíte uzavřít do uvozovek, jak je znázorněno v příkladu.

Příklad 8: Získání instancí přidružení souvisejících se zadanou instancí

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

Tento příkaz získá instance přidružení, které souvisejí se zadanou instancí (winrm). Vzhledem k tomu, že hodnota dialektu je asociace a používá se parametr Association, tento příkaz vrátí instance přidružení, nikoli přidružené instance.

Filtr musíte uzavřít do uvozovek, jak je znázorněno v příkladu.

Parametry

-ApplicationName

Určuje název aplikace v připojení. Výchozí hodnota parametru ApplicationName je WSMAN. Úplný identifikátor vzdáleného koncového bodu je v následujícím formátu:

Příklad: http://server01:8080/WSMAN

Internetová informační služba (IIS), která hostuje relaci, předává požadavky s tímto koncovým bodem do zadané aplikace. Toto výchozí nastavení WSMAN je vhodné pro většinu použití. Tento parametr je navržený tak, aby se používal, pokud mnoho počítačů navazuje vzdálená připojení k jednomu počítači, na kterém běží PowerShell. V tomto případě služba IIS hostuje službu WS-Management, aby byla efektivní.

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

-Associations

Označuje, že tato rutina získá instance přidružení, nikoli přidružené instance. Tento parametr můžete použít pouze v případě, že má parametr Dialekt hodnotu Association.

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

-Authentication

Určuje mechanismus ověřování, který se má použít na serveru. Tento parametr přijímá tyto hodnoty:

Basic - Základní je schéma, ve kterém se uživatelské jméno a heslo odesílají na server nebo proxy server ve formátu prostého textu.
Default – Použijte metodu ověřování implementovanou protokolem WS-Management. Tato možnost je výchozí.
Digest - Digest je schéma odpovědí na výzvu, které pro výzvu používá datový řetězec zadaný serverem.
Kerberos – Klientský počítač a server se vzájemně ověřují pomocí certifikátů Kerberos.
Negotiate - Negotiate je schéma odezvy výzvy, které vyjednává se serverem nebo proxy serverem k určení schématu, které se má použít k ověřování. Tato hodnota parametru například umožňuje vyjednávání zjistit, jestli se používá protokol Kerberos nebo NTLM.
CredSSP – Použijte ověřování zprostředkovatele podpory zabezpečení přihlašovacích údajů (CredSSP), které umožňuje delegování přihlašovacích údajů uživatele. Tato možnost je určená pro příkazy, které běží na jednom vzdáleném počítači, ale shromažďují data z jiných vzdálených počítačů nebo spouštějí další příkazy.

Upozornění

CredSSP deleguje přihlašovací údaje uživatele z místního počítače na vzdálený počítač. Tento postup zvyšuje riziko zabezpečení vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, lze při předání přihlašovacích údajů použít k řízení síťové relace.

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

Označuje, že tato rutina vyčísluje pouze vlastnosti, které jsou součástí základní třídy určené parametrem ResourceURI . Tento parametr nemá žádný vliv, pokud je zadán parametr Shallow .

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

-CertificateThumbprint

Určuje certifikát digitálního veřejného klíče (X509) uživatelského účtu, který má oprávnění k provedení této akce. Zadejte kryptografický otisk certifikátu.

Certifikáty se používají při ověřování na základě klientských certifikátů. Mohou být mapovány pouze na místní uživatelské účty; nefungují s doménovými účty.

Pokud chcete získat kryptografický otisk certifikátu, použijte Get-Item jednotku PowerShell Cert: nebo Get-ChildItem příkaz.

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

-ComputerName

Určuje počítač, pro který má být spuštěna operace správy. Hodnota může být plně kvalifikovaný název domény, název NetBIOS nebo IP adresa. Použijte název místního počítače, použijte localhost nebo použijte tečku (.) k určení místního počítače. Místní počítač je výchozí. Pokud je vzdálený počítač v jiné doméně než uživatel, musíte použít plně kvalifikovaný název domény. Do rutiny můžete zadat hodnotu tohoto parametru.

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

-ConnectionURI

Určuje koncový bod připojení. Formát tohoto řetězce je následující:

Následující řetězec je správně naformátovaná hodnota pro tento parametr:

http://Server01:8080/WSMAN

Identifikátor URI musí být plně kvalifikovaný.

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

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Ve výchozím nastavení je to aktuální uživatel. Zadejte uživatelské jméno, například User01, Domain01\User01 nebo User@Domain.com. Nebo zadejte objekt PSCredential , například objekt vrácený rutinou Get-Credential . Když zadáte uživatelské jméno, tato rutina vás vyzve k zadání hesla.

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

-Dialect

Určuje dialekt, který se má použít v predikátu filtru. Může to být jakýkoli dialekt, který vzdálená služba podporuje. Pro identifikátor URI dialektu je možné použít následující aliasy:

WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
Volič- http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
Přidružení- 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

Označuje, že tato rutina vrátí všechny instance prostředku správy.

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

-Filter

Určuje výraz filtru pro výčet. Pokud zadáte tento parametr, musíte také zadat Dialekt.

Platné hodnoty tohoto parametru závisí na dialektu zadaném v dialektu. Pokud je například dialekt WQL, musí parametr filtru obsahovat řetězec a řetězec musí obsahovat platný dotaz WQL, například následující dotaz:

"Select * from Win32_Service where State != Running"

Pokud je dialekt asociace, filtr musí obsahovat řetězec a řetězec musí obsahovat platný filtr, například následující 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

Určuje oddíl uvnitř instance, která se má aktualizovat nebo načíst pro zadanou operaci. Pokud chcete například získat stav služby zařazování, zadejte následující:

-Fragment Status

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

-OptionSet

Určuje sadu přepínačů do služby, která upraví nebo upřesní povahu požadavku. Tyto přepínače se podobají přepínačům používaným v prostředích příkazového řádku, protože jsou specifické pro službu. Můžete zadat libovolný počet možností.

Následující příklad ukazuje syntaxi, která předává hodnoty 1, 2 a 3 pro parametry a, b a 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

Určuje port, který se má použít, když se klient připojí ke službě WinRM. Pokud je přenos HTTP, výchozí port je 80. Když je přenos HTTPS, výchozí port je 443.

Při použití PROTOKOLU HTTPS jako přenosu musí hodnota parametru ComputerName odpovídat běžnému názvu certifikátu serveru (CN). Pokud je však parametr SkipCNCheck zadán jako součást parametru SessionOption , běžný název certifikátu serveru se nemusí shodovat s názvem hostitele serveru. Parametr SkipCNCheck by se měl používat jenom pro důvěryhodné počítače.

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

-ResourceURI

Určuje identifikátor URI třídy prostředků nebo instance. Identifikátor URI identifikuje konkrétní typ prostředku, například disky nebo procesy, v počítači.

Identifikátor URI se skládá z předpony a cesty prostředku. Příklad:

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

Určuje typ dat, která se mají vrátit. Tento parametr přijímá tyto hodnoty:

Object
EPR
ObjectAndEPR

Výchozí hodnota je Object.

Pokud zadáte nebo nezadáte Object tento parametr, tato rutina vrátí pouze objekty. Pokud zadáte odkaz na koncový bod (EPR), tato rutina vrátí pouze odkazy na koncové body objektů. Odkazy na koncové body obsahují informace o identifikátoru URI prostředku a selektorech instance. Pokud zadáte ObjectAndEPR, vrátí tato rutina objekt i přidružené odkazy na koncové body.

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

Určuje sadu párů hodnot, které se používají k výběru konkrétních instancí prostředků správy. Parametr SelectorSet se používá, pokud existuje více instancí prostředku. Hodnota parametru SelectorSet musí být tabulka hash.

Následující příklad ukazuje, jak zadat hodnotu pro tento parametr:

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

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

-SessionOption

Určuje rozšířené možnosti pro relaci WS-Management. Zadejte objekt SessionOption, který vytvoříte pomocí rutiny New-WSManSessionOption. Další informace o možnostech, které jsou k dispozici, zadejte Get-Help New-WSManSessionOption.

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

-Shallow

Označuje, že tato rutina vrací pouze instance základní třídy zadané v identifikátoru URI prostředku. Pokud tento parametr nezadáte, vrátí tato rutina instance základní třídy, která je zadána v identifikátoru URI a ve všech jeho odvozených třídách.

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

-UseSSL

Určuje, že protokol SSL (Secure Sockets Layer) slouží k navázání připojení ke vzdálenému počítači. Ve výchozím nastavení se ssl nepoužívá.

WS-Management šifruje veškerý obsah Windows PowerShellu přenášený přes síť. Parametr UseSSL umožňuje zadat další ochranu HTTPS místo protokolu HTTP. Pokud protokol SSL není k dispozici na portu, který se používá pro připojení, a zadáte tento parametr, příkaz selže.

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

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

XmlElement

Tato rutina vrátí objekt XMLElement .

Get-WSManInstance

Syntax

Description

Příklady

Příklad 1: Získání všech informací z rozhraní WMI

Příklad 2: Získání stavu služby zařazování

Příklad 3: Získání odkazů na koncové body pro všechny služby

Příklad 4: Získání služeb, které splňují zadaná kritéria

Příklad 5: Získání konfigurace naslouchacího procesu, která odpovídá kritériím v místním počítači

Příklad 6: Získání konfigurace naslouchacího procesu, která odpovídá kritériím na vzdáleném počítači

Příklad 7: Získání přidružených instancí souvisejících se zadanou instancí

Příklad 8: Získání instancí přidružení souvisejících se zadanou instancí

Parametry

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Vstupy

Výstupy

Váš názor

Další materiály

Get-WSManInstance

Syntax

Description

Příklady

Příklad 1: Získání všech informací z rozhraní WMI

Příklad 2: Získání stavu služby zařazování

Příklad 3: Získání odkazů na koncové body pro všechny služby

Příklad 4: Získání služeb, které splňují zadaná kritéria

Příklad 5: Získání konfigurace naslouchacího procesu, která odpovídá kritériím v místním počítači

Příklad 6: Získání konfigurace naslouchacího procesu, která odpovídá kritériím na vzdáleném počítači

Příklad 7: Získání přidružených instancí souvisejících se zadanou instancí

Příklad 8: Získání instancí přidružení souvisejících se zadanou instancí

Parametry

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Vstupy

Výstupy

Související odkazy

Váš názor

Další materiály