Get-WSManInstance

Syntax

GetInstance (Standard)

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

Enumerate

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

Description

Exempel

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

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

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

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

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

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

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"

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

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

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

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

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

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

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

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

Parametrar

-ApplicationName

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

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

Till exempel: 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 utformad för 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.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-Authentication

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

• Basic – Basic ä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 – Digest är ett utmaningssvarsschema som använder en serverspecifik datasträng för utmaningen.
• Kerberos – Klientdatorn och servern autentiserar ömsesidigt med hjälp av Kerberos-certifikat.
• Negotiate – Negotiate är ett utmaningssvarsschema som förhandlar med servern eller proxyn för att fastställa vilket schema som ska användas för autentisering. Det här parametervärdet gör det till exempel möjligt att förhandla för att avgöra om Kerberos-protokollet eller NTLM används.
• CredSSP – Använd CredSSP-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 som samlar in data från eller kör ytterligare kommandon på andra fjärrdatorer.

Parameteregenskaper

Parameteruppsättningar

-BasePropertiesOnly

Anger att den här cmdleten bara räknar upp de egenskaper som ingår i basklassen som anges av parametern ResourceURI. Den här parametern har ingen effekt om parametern Shallow anges.

Parameteregenskaper

Parameteruppsättningar

-CertificateThumbprint

Anger det digitala offentliga nyckelcertifikatet (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 certifikat använder du kommandot Get-Item eller Get-ChildItem i PowerShell Cert: -enheten.

Parameteregenskaper

Parameteruppsättningar

-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 domännamn. Du kan skicka ett värde för den här parametern till cmdleten.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-Credential

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

Parameteregenskaper

Parameteruppsättningar

-Dialect

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

• WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
• Väljare – http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• Association – http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Parameteregenskaper

Parameteruppsättningar

-Enumerate

Anger att denna cmdlet returnerar alla instanser av en hanteringsresurs.

Parameteregenskaper

Parameteruppsättningar

-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 till exempel Dialekt är WQL måste parametern Filter 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 Filter 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\]}

Parameteregenskaper

Parameteruppsättningar

-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 spooler-tjänst anger du följande:

-Fragment Status

Parameteregenskaper

Parameteruppsättningar

-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 syntaxen som skickar värdena 1, 2 och 3 för parametrarna a, b och c:

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

Parameteregenskaper

Parameteruppsättningar

-Port

Anger den 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 gemensamma certifikatnamn (CN). Om parametern SkipCNCheck anges som en del av parametern SessionOption behöver certifikatets gemensamma namn inte matcha serverns värdnamn. Parametern SkipCNCheck ska endast användas för betrodda datorer.

Parameteregenskaper

Parameteruppsättningar

-ResourceURI

Anger URI för resursklassen eller instansen. URI:n identifierar en specifik 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. Till 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

Parameteregenskaper

Parameteruppsättningar

-ReturnType

Anger vilken typ av data som ska returneras. De godtagbara 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 den här cmdleten 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 väljare för instansen. Om du anger ObjectAndEPRreturnerar den här cmdleten både objektet och dess associerade slutpunktsreferenser.

Parameteregenskaper

Parameteruppsättningar

-SelectorSet

Anger en uppsättning värdepar som används för att välja specifika hanteringsresursinstanser. Parametern SelectorSet används när mer än en instans av resursen finns. 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"}

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-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 den här cmdleten instanser av basklassen som anges i URI:n och i alla dess härledda klasser.

Parameteregenskaper

Parameteruppsättningar

-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å porten som används för anslutningen och du anger den här parametern misslyckas kommandot.

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

None

Utdata

XmlElement

Relaterade länkar

• Connect-WSMan
• Disable-WSManCredSSP
• Koppla från-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption
• Ta bort-WSManInstance
• Set-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan