Get-WSManInstance

Modul:

Microsoft.WSMan.Management

Visar hanteringsinformation för en resursinstans som anges av en resurs-URI.

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

Cmdleten Get-WSManInstance hämtar en instans av en hanteringsresurs som anges av en resurs-URI (Uniform Resource Identifier). Den information som hämtas kan vara en komplex XML-informationsuppsättning, som är ett objekt eller ett enkelt värde. Den här cmdleten motsvarar standardkommandot Web Services for Management (WS-Management).

Den här cmdleten använder WS-Management-anslutnings-/transportlagret för att hämta information.

Exempel

Exempel 1: Hämta all information från WMI

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

Det här kommandot returnerar all information som WMI (Windows Management Instrumentation) visar om WinRM-tjänsten på fjärrservern01-datorn.

Exempel 2: Hämta status för Spooler-tjänsten

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

Det här kommandot returnerar endast status för Spooler-tjänsten på fjärrservern01-datorn.

Exempel 3: Hämta slutpunktsreferenser för alla tjänster

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

Det här kommandot returnerar slutpunktsreferenser som motsvarar alla tjänster på den lokala datorn.

Exempel 4: Hämta tjänster som uppfyller angivna villkor

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

Det här kommandot visar alla tjänster som uppfyller följande villkor på den fjärranslutna Server01-datorn:

• Starttypen för tjänsten är Automatisk.
• Tjänsten har stoppats.

Exempel 5: Hämta lyssnarkonfiguration som matchar kriterierna på den lokala datorn

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

Det här kommandot visar WS-Management-lyssnarkonfigurationen på den lokala datorn för lyssnaren som matchar kriterierna i väljaren.

Exempel 6: Hämta lyssnarkonfiguration som matchar kriterier på en fjärrdator

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

Det här kommandot visar WS-Management-lyssnarkonfigurationen på fjärrserver01-datorn för lyssnaren som matchar kriterierna i väljareuppsättningen.

Exempel 7: Hämta associerade instanser relaterade till en angiven instans

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

Det här kommandot hämtar de associerade instanser som är relaterade till den angivna instansen (winrm).

Du måste omge filtret med citattecken, som du ser i exemplet.

Exempel 8: Hämta associationsinstanser relaterade till en angiven instans

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

Det här kommandot hämtar associationsinstanser som är relaterade till den angivna instansen (winrm). Eftersom dialektvärdet är association och parametern Associations används returnerar det här kommandot associationsinstanser, inte associerade instanser.

Du måste omge filtret med citattecken, som du ser i exemplet.

Parametrar

-ApplicationName

Anger programnamnet i anslutningen. Standardvärdet för parametern ApplicationName är WSMAN. Den fullständiga identifieraren för fjärrslutpunkten har följande format:

<transport>://<server>:<port>/<ApplicationName>

Exempelvis: http://server01:8080/WSMAN

Internet Information Services (IIS), som är värd för sessionen, vidarebefordrar begäranden med den här slutpunkten till det angivna programmet. Den här standardinställningen för WSMAN är lämplig för de flesta användningsområden. Den här parametern är avsedd att användas om många datorer upprättar fjärranslutningar till en dator som kör PowerShell. I det här fallet är IIS-värdar WS-Management för effektivitet.

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

-Associations

Anger att denna cmdlet hämtar associationsinstanser, inte associerade instanser. Du kan bara använda den här parametern när parametern Dialekt har värdet Association.

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

-Authentication

Anger vilken autentiseringsmekanism som ska användas på servern. De acceptabla värdena för den här parametern är:

• Basic – Grundläggande är ett schema där användarnamnet och lösenordet skickas i klartext till servern eller proxyn.
• Default – Använd autentiseringsmetoden som implementeras av WS-Management-protokollet. Det här är standardinställningen.
• Digest – Sammanfattning är ett schema för utmaningssvar som använder en server angiven datasträng för utmaningen.
• Kerberos – Klientdatorn och servern autentiseras ömsesidigt med hjälp av Kerberos-certifikat.
• Negotiate – Förhandla är ett schema för utmaningssvar som förhandlar med servern eller proxyservern för att fastställa vilket schema som ska användas för autentisering. Det här parametervärdet möjliggör till exempel förhandling för att avgöra om Kerberos-protokollet eller NTLM används.
• CredSSP – Använd Credential Security Support Provider-autentisering (CredSSP), vilket gör att användaren kan delegera autentiseringsuppgifter. Det här alternativet är utformat för kommandon som körs på en fjärrdator men samlar in data från eller kör ytterligare kommandon på andra fjärrdatorer.

Varning

CredSSP delegerar användarens autentiseringsuppgifter från den lokala datorn till en fjärrdator. Den här metoden ökar säkerhetsrisken för fjärråtgärden. Om fjärrdatorn komprometteras kan autentiseringsuppgifterna användas för att styra nätverkssessionen när autentiseringsuppgifterna skickas till den.

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

Anger att denna cmdlet endast räknar upp de egenskaper som ingår i basklassen som anges av ResourceURI-parametern . Den här parametern har ingen effekt om parametern Shallow har angetts.

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

-CertificateThumbprint

Anger certifikatet för den digitala offentliga nyckeln (X509) för ett användarkonto som har behörighet att utföra den här åtgärden. Ange certifikatets tumavtryck.

Certifikat används i klientcertifikatbaserad autentisering. De kan endast mappas till lokala användarkonton. de fungerar inte med domänkonton.

Om du vill hämta ett tumavtryck för certifikatet Get-Item använder du kommandot eller Get-ChildItem i PowerShell Cert:-enheten.

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

-ComputerName

Anger den dator som hanteringsåtgärden ska köras mot. Värdet kan vara ett fullständigt kvalificerat domännamn, ett NetBIOS-namn eller en IP-adress. Använd namnet på den lokala datorn, använd localhost eller använd en punkt (.) för att ange den lokala datorn. Den lokala datorn är standard. När fjärrdatorn finns i en annan domän än användaren måste du använda ett fullständigt kvalificerat domännamn. Du kan skicka ett värde för den här parametern till cmdleten .

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

-ConnectionURI

Anger anslutningsslutpunkten. Formatet för den här strängen är följande:

<Transport>://<Server>:<Port>/<ApplicationName>

Följande sträng är ett korrekt formaterat värde för den här parametern:

http://Server01:8080/WSMAN

URI:n måste vara fullständigt kvalificerad.

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

-Credential

Anger ett användarkonto som har behörighet att utföra den här åtgärden. Standard är den aktuella användaren. Ange ett användarnamn, till exempel User01, Domain01\User01 eller User@Domain.com. Eller ange ett PSCredential-objekt , till exempel ett objekt som returneras av cmdleten Get-Credential . När du skriver ett användarnamn uppmanas du av den här cmdleten att ange ett lösenord.

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

-Dialect

Anger vilken dialekt som ska användas i filterpredikatet. Detta kan vara vilken dialekt som helst som stöds av fjärrtjänsten. Följande alias kan användas för dialektens URI:

• WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
• Selector- http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• Association- 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

Anger att denna cmdlet returnerar alla instanser av en hanteringsresurs.

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

-Filter

Anger filteruttrycket för uppräkningen. Om du anger den här parametern måste du också ange Dialekt.

De giltiga värdena för den här parametern beror på den dialekt som anges i Dialekt. Om dialekt till exempel är WQL måste filterparametern innehålla en sträng och strängen måste innehålla en giltig WQL-fråga, till exempel följande fråga:

"Select * from Win32_Service where State != Running"

Om Dialekt är Association måste filtret innehålla en sträng och strängen måste innehålla ett giltigt filter, till exempel följande filter:

-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

Anger ett avsnitt i instansen som ska uppdateras eller hämtas för den angivna åtgärden. Om du till exempel vill hämta status för en bufferttjänst anger du följande:

-Fragment Status

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

-OptionSet

Anger en uppsättning växlar till en tjänst för att ändra eller förfina typen av begäran. Dessa liknar växlar som används i kommandoradsgränssnitt eftersom de är tjänstspecifika. Valfritt antal alternativ kan anges.

I följande exempel visas den syntax som skickar värdena 1, 2 och 3 för parametrarna a, b och 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

Anger vilken port som ska användas när klienten ansluter till WinRM-tjänsten. När transporten är HTTP är standardporten 80. När transporten är HTTPS är standardporten 443.

När du använder HTTPS som transport måste värdet för parametern ComputerName matcha serverns certifikatnamn (CN). Men om parametern SkipCNCheck anges som en del av parametern SessionOption behöver certifikatets gemensamma namn på servern inte matcha serverns värdnamn. Parametern SkipCNCheck ska endast användas för betrodda datorer.

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

-ResourceURI

Anger URI för resursklassen eller instansen. URI:n identifierar en viss typ av resurs, till exempel diskar eller processer, på en dator.

En URI består av ett prefix och en sökväg till en resurs. Exempel:

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

Anger vilken typ av data som ska returneras. De acceptabla värdena för den här parametern är:

• Object
• EPR
• ObjectAndEPR

Standardvärdet är Object.

Om du anger Object eller inte anger den här parametern returnerar denna cmdlet endast objekt. Om du anger slutpunktsreferens (EPR) returnerar den här cmdleten endast slutpunktsreferenserna för objekten. Slutpunktsreferenser innehåller information om resurs-URI:n och instansens väljare. Om du anger ObjectAndEPRreturnerar den här cmdleten både objektet och dess associerade slutpunktsreferenser.

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

Anger en uppsättning värdepar som används för att välja specifika hanteringsresursinstanser. Parametern SelectorSet används när det finns fler än en instans av resursen. Värdet för parametern SelectorSet måste vara en hash-tabell.

I följande exempel visas hur du anger ett värde för den här parametern:

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

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

-SessionOption

Anger utökade alternativ för den WS-Management sessionen. Ange ett SessionOption-objekt som du skapar med hjälp av cmdleten New-WSManSessionOption. Om du vill ha mer information om de tillgängliga alternativen skriver du Get-Help New-WSManSessionOption.

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

-Shallow

Anger att denna cmdlet endast returnerar instanser av basklassen som anges i resurs-URI:n. Om du inte anger den här parametern returnerar denna cmdlet instanser av basklassen som anges i URI:n och i alla dess härledda klasser.

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

-UseSSL

Anger att SSL-protokollet (Secure Sockets Layer) används för att upprätta en anslutning till fjärrdatorn. Som standard används inte SSL.

WS-Management krypterar allt Windows PowerShell innehåll som överförs via nätverket. Med parametern UseSSL kan du ange ytterligare skydd för HTTPS i stället för HTTP. Om SSL inte är tillgängligt på den port som används för anslutningen och du anger den här parametern misslyckas kommandot.

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

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

XmlElement

Den här cmdleten returnerar ett XMLElement-objekt .

Relaterade länkar

• Connect-WSMan
• Disable-WSManCredSSP
• Disconnect-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption
• Remove-WSManInstance
• Set-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan