Get-WSManInstance

Referentie

Module:: Microsoft.WsMan.Management

Geeft beheergegevens weer voor een resource-exemplaar dat is opgegeven door een resource-URI.

Syntaxis

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

De Get-WSManInstance-cmdlet haalt een exemplaar op van een beheerresource die is opgegeven door een URI (Resource Uniform Resource Identifier). De informatie die wordt opgehaald, kan een complexe XML-gegevensset zijn, een object of een eenvoudige waarde. Deze cmdlet is gelijk aan de standaardopdracht Web Services for Management (WS-Management) Get.

Deze cmdlet maakt gebruik van de WS-Management verbindings-/transportlaag om informatie op te halen.

Voorbeelden

Voorbeeld 1: Alle informatie ophalen uit WMI

PS C:\> Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="winrm"} -ComputerName "Server01"
xsi                     : http://www.w3.org/2001/XMLSchema-instance
p                       : https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim                     : http://schemas.dmtf.org/wbem/wscim/1/common
type                    : p:Win32_Service_Type
lang                    : en-US
AcceptPause             : false
AcceptStop              : true
Caption                 : Windows Remote Management (WS-Management)
CheckPoint              : 0
CreationClassName       : Win32_Service
Description             : Windows Remote Management (WinRM) service implements the WS-Management protocol for remote
management. WS-Management is a standard web services protocol used for remote software and
hardware management. The WinRM service listens on the network for WS-Management requests
and processes them. The WinRM Service needs to be configured with a listener using the
winrm.cmd command line tool or through Group Policy in order for it to listen over the
network. The WinRM service provides access to WMI data and enables event collection. Event
collection and subscription to events require that the service is running. WinRM messages
use HTTP and HTTPS as transports. The WinRM service does not depend on IIS but is
preconfigured to share a port with IIS on the same computer.  The WinRM service reserves the
/wsman URL prefix. To prevent conflicts with IIS, administrators should ensure that any
websites hosted on IIS do not use the /wsman URL prefix.
DesktopInteract         : false
DisplayName             : Windows Remote Management (WS-Management)
ErrorControl            : Normal
ExitCode                : 0
InstallDate             : InstallDate
Name                    : winrm
PathName                : C:\Windows\System32\svchost.exe -k NetworkService
ProcessId               : 948
ServiceSpecificExitCode : 0
ServiceType             : Share Process
Started                 : true
StartMode               : Auto
StartName               : NT AUTHORITY\NetworkService
State                   : Running
Status                  : OK
SystemCreationClassName : Win32_ComputerSystem
SystemName              : SERVER01
TagId                   : 0
WaitHint                : 0

Met deze opdracht wordt alle informatie geretourneerd die Windows Management Instrumentation (WMI) beschikbaar maakt over de WinRM--service op de externe server01-computer.

Voorbeeld 2: De status van de Spooler-service ophalen

PS C:\> Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="spooler"} -Fragment Status -ComputerName "Server01"
XmlFragment=OK

Met deze opdracht wordt alleen de status van de Spooler-service op de externe server01-computer geretourneerd.

Voorbeeld 3: Eindpuntverwijzingen ophalen voor alle services

PS C:\> Get-WSManInstance -Enumerate -ResourceURI wmicimv2/win32_service -ReturnType EPR
xsi                     : http://www.w3.org/2001/XMLSchema-instance
p                       : https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim                     : http://schemas.dmtf.org/wbem/wscim/1/common
type                    : p:Win32_Service_Type
lang                    : en-US
AcceptPause             : false
AcceptStop              : false
Caption                 : Visual Studio 2008 Remote Debugger
CheckPoint              : 0
CreationClassName       : Win32_Service
Description             : Allows members of the Administrators group to remotely debug server applications using Visual
Studio 2008. Use the Visual Studio 2008 Remote Debugging Configuration Wizard to enable this
service.
DesktopInteract         : false
DisplayName             : Visual Studio 2008 Remote Debugger
ErrorControl            : Ignore
ExitCode                : 1077
InstallDate             : InstallDate
Name                    : msvsmon90
PathName                : "C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\Remote Debugger\x86\msvsmon.exe" /service msvsmon90
ProcessId               : 0
ServiceSpecificExitCode : 0
ServiceType             : Own Process
Started                 : false
StartMode               : Disabled
StartName               : LocalSystem
State                   : Stopped
Status                  : OK
SystemCreationClassName : Win32_ComputerSystem
SystemName              : COMPUTER01
TagId                   : 0
WaitHint                : 0
...

Met deze opdracht worden eindpuntverwijzingen geretourneerd die overeenkomen met alle services op de lokale computer.

Voorbeeld 4: Services ophalen die voldoen aan opgegeven criteria

PS C:\> Get-WSManInstance -Enumerate -ResourceURI wmicimv2/* -Filter "select * from win32_service where StartMode = 'Auto' and State = 'Stopped'" -ComputerName "Server01"
xsi                     : http://www.w3.org/2001/XMLSchema-instance
p                       : https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim                     : http://schemas.dmtf.org/wbem/wscim/1/common
type                    : p:Win32_Service_Type
lang                    : en-US
AcceptPause             : false
AcceptStop              : false
Caption                 : Windows Media Center Service Launcher
CheckPoint              : 0
CreationClassName       : Win32_Service
Description             : Starts Windows Media Center Scheduler and Windows Media Center Receiver services
at startup if TV is enabled within Windows Media Center.
DesktopInteract         : false
DisplayName             : Windows Media Center Service Launcher
ErrorControl            : Ignore
ExitCode                : 0
InstallDate             : InstallDate
Name                    : ehstart
PathName                : C:\Windows\system32\svchost.exe -k LocalServiceNoNetwork
ProcessId               : 0
ServiceSpecificExitCode : 0
ServiceType             : Share Process
Started                 : false
StartMode               : Auto
StartName               : NT AUTHORITY\LocalService
State                   : Stopped
Status                  : OK
SystemCreationClassName : Win32_ComputerSystem
SystemName              : Server01
TagId                   : 0
WaitHint                : 0
...

Met deze opdracht worden alle services vermeld die voldoen aan de volgende criteria op de externe Server01-computer:

Het opstarttype van de service is Automatisch.
De service is gestopt.

Voorbeeld 5: Listenerconfiguratie ophalen die overeenkomt met criteria op de lokale computer

PS C:\> Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"}
cfg                   : https://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTP
Port                  : 80
Hostname              :
Enabled               : true
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {100.0.0.1, 123.123.123.123, ::1, 2001:4898:0:fff:0:5efe:123.123.123.123...}

Met deze opdracht wordt de WS-Management listenerconfiguratie op de lokale computer weergegeven voor de listener die overeenkomt met de criteria in de selectorset.

Voorbeeld 6: Listenerconfiguratie ophalen die overeenkomt met criteria op een externe computer

PS C:\> Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"} -ComputerName "Server01"
cfg                   : https://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTP
Port                  : 80
Hostname              :
Enabled               : true
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {100.0.0.1, 123.123.123.124, ::1, 2001:4898:0:fff:0:5efe:123.123.123.124...}

Met deze opdracht wordt de configuratie van de WS-Management listener op de externe server01-computer weergegeven voor de listener die voldoet aan de criteria in de selectieset.

Voorbeeld 7: Gekoppelde exemplaren ophalen die zijn gerelateerd aan een opgegeven instantie

PS C:\> Get-WSManInstance -Enumerate -Dialect Association -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*
xsi                       : http://www.w3.org/2001/XMLSchema-instance
p                         : https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_ComputerSystem
cim                       : http://schemas.dmtf.org/wbem/wscim/1/common
type                      : p:Win32_ComputerSystem_Type
lang                      : en-US
AdminPasswordStatus       : 1
AutomaticManagedPagefile  : true
AutomaticResetBootOption  : true
AutomaticResetCapability  : true
BootOptionOnLimit         : BootOptionOnLimit
BootOptionOnWatchDog      : BootOptionOnWatchDog
BootROMSupported          : true
BootupState               : Normal boot
Caption                   : SERVER01
ChassisBootupState        : 3
CreationClassName         : Win32_ComputerSystem
CurrentTimeZone           : -480
DaylightInEffect          : false
Description               : AT/AT COMPATIBLE
DNSHostName               : server01
Domain                    : site01.corp.fabrikam.com
DomainRole                : 1
EnableDaylightSavingsTime : true
FrontPanelResetStatus     : 2
InfraredSupported         : false
InstallDate               : InstallDate
KeyboardPasswordStatus    : 2
LastLoadInfo              : LastLoadInfo
Manufacturer              : Dell Inc.
Model                     : OptiPlex 745
Name                      : SERVER01
NameFormat                : NameFormat
NetworkServerModeEnabled  : true
NumberOfLogicalProcessors : 2
NumberOfProcessors        : 1
OEMStringArray            : www.dell.com
PartOfDomain              : true
PauseAfterReset           : -1
PCSystemType              : 5
PowerManagementSupported  : PowerManagementSupported
PowerOnPasswordStatus     : 1
PowerState                : 0
PowerSupplyState          : 3
PrimaryOwnerContact       : PrimaryOwnerContact
PrimaryOwnerName          : testuser01
ResetCapability           : 1
ResetCount                : -1
ResetLimit                : -1
Roles                     : {LM_Workstation, LM_Server, SQLServer, NT}
Status                    : OK
SystemStartupDelay        : SystemStartupDelay
SystemStartupSetting      : SystemStartupSetting
SystemType                : X86-based PC
ThermalState              : 3
TotalPhysicalMemory       : 3217760256
UserName                  : FABRIKAM\testuser01
WakeUpType                : 6
Workgroup                 : Workgroup
xsi                     : http://www.w3.org/2001/XMLSchema-instance
p                       : https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim                     : http://schemas.dmtf.org/wbem/wscim/1/common
type                    : p:Win32_Service_Type
lang                    : en-US
AcceptPause             : false
AcceptStop              : false
Caption                 : Remote Procedure Call (RPC)
CheckPoint              : 0
CreationClassName       : Win32_Service
Description             : Serves as the endpoint mapper and COM Service Control Manager. If this service is stopped
or disabled, programs using COM or Remote Procedure Call (RPC) services will not function
properly.
DesktopInteract         : false
DisplayName             : Remote Procedure Call (RPC)
ErrorControl            : Normal
ExitCode                : 0
InstallDate             : InstallDate
Name                    : RpcSs
PathName                : C:\Windows\system32\svchost.exe -k rpcss
ProcessId               : 1100
ServiceSpecificExitCode : 0
ServiceType             : Share Process
Started                 : true
StartMode               : Auto
StartName               : NT AUTHORITY\NetworkService
State                   : Running
Status                  : OK
SystemCreationClassName : Win32_ComputerSystem
SystemName              : SERVER01
TagId                   : 0
WaitHint                : 0

xsi                     : http://www.w3.org/2001/XMLSchema-instance
p                       : https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_SystemDriver
cim                     : http://schemas.dmtf.org/wbem/wscim/1/common
type                    : p:Win32_SystemDriver_Type
lang                    : en-US
AcceptPause             : false
AcceptStop              : true
Caption                 : HTTP
CreationClassName       : Win32_SystemDriver
Description             : HTTP
DesktopInteract         : false
DisplayName             : HTTP
ErrorControl            : Normal
ExitCode                : 0
InstallDate             : InstallDate
Name                    : HTTP
PathName                : C:\Windows\system32\drivers\HTTP.sys
ServiceSpecificExitCode : 0
ServiceType             : Kernel Driver
Started                 : true
StartMode               : Manual
StartName               :
State                   : Running
Status                  : OK
SystemCreationClassName : Win32_ComputerSystem
SystemName              : SERVER01
TagId                   : 0

Met deze opdracht worden de bijbehorende exemplaren ophaalt die zijn gerelateerd aan het opgegeven exemplaar (winrm).

U moet het filter tussen aanhalingstekens plaatsen, zoals wordt weergegeven in het voorbeeld.

Voorbeeld 8: Koppelingsexemplaren ophalen die zijn gerelateerd aan een opgegeven instantie

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

Met deze opdracht worden koppelingsexemplaren ophaalt die zijn gerelateerd aan het opgegeven exemplaar (winrm). Omdat de Dialect waarde een koppeling is en de koppelingen parameter wordt gebruikt, retourneert deze opdracht koppelingsexemplaren, niet gekoppelde exemplaren.

U moet het filter tussen aanhalingstekens plaatsen, zoals wordt weergegeven in het voorbeeld.

Parameters

-ApplicationName

Hiermee geeft u de naam van de toepassing in de verbinding. De standaardwaarde van de parameter ApplicationName is WSMAN. De volledige id voor het externe eindpunt heeft de volgende indeling:

Bijvoorbeeld: http://server01:8080/WSMAN

Internet Information Services (IIS), die als host fungeert voor de sessie, stuurt aanvragen met dit eindpunt door naar de opgegeven toepassing. Deze standaardinstelling van WSMAN is geschikt voor de meeste toepassingen. Deze parameter is ontworpen om te worden gebruikt als veel computers externe verbindingen tot stand brengen met één computer waarop PowerShell wordt uitgevoerd. In dit geval worden IIS-hosts WS-Management voor efficiëntie.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Associations

Geeft aan dat deze cmdlet koppelingsexemplaren ophaalt, niet gekoppelde exemplaren. U kunt deze parameter alleen gebruiken wanneer de parameter Dialect de waarde Association heeft.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Authentication

Hiermee geeft u het verificatiemechanisme dat moet worden gebruikt op de server. De acceptabele waarden voor deze parameter zijn:

Basisch. Basic is een schema waarin de gebruikersnaam en het wachtwoord in duidelijke tekst naar de server of proxy worden verzonden.
Verstek. Gebruik de verificatiemethode die is geïmplementeerd door het WS-Management-protocol. Dit is de standaardwaarde.
Verteren. Digest is een challenge-response-schema dat gebruikmaakt van een door de server opgegeven gegevensreeks voor de uitdaging.
Kerberos. De clientcomputer en de server verifiëren elkaar wederzijds met behulp van Kerberos-certificaten.
Onderhandelen. Onderhandelen is een vraag-antwoordschema dat onderhandelt met de server of proxy om het schema te bepalen dat moet worden gebruikt voor verificatie. Met deze parameterwaarde kan bijvoorbeeld worden onderhandeld of het Kerberos-protocol of NTLM wordt gebruikt.
CredSSP. Gebruik CredSSP-verificatie (Credential Security Support Provider), waarmee de gebruiker referenties kan delegeren. Deze optie is ontworpen voor opdrachten die op één externe computer worden uitgevoerd, maar gegevens verzamelen van of aanvullende opdrachten uitvoeren op andere externe computers.

Waarschuwing: CredSSP delegeert de gebruikersreferenties van de lokale computer naar een externe computer. Deze praktijk verhoogt het beveiligingsrisico van de externe bewerking. Als de externe computer wordt aangetast, kunnen de referenties worden gebruikt om de netwerksessie te beheren wanneer er referenties aan worden doorgegeven.

Type:	AuthenticationMechanism
Aliassen:	auth, am
Geaccepteerde waarden:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BasePropertiesOnly

Geeft aan dat deze cmdlet alleen de eigenschappen opsommen die deel uitmaken van de basisklasse die is opgegeven door de parameter ResourceURI. Deze parameter heeft geen effect als de parameter Ondiepe is opgegeven.

Type:	SwitchParameter
Aliassen:	UBPO, Base
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CertificateThumbprint

Hiermee geeft u het certificaat van de digitale openbare sleutel (X509) van een gebruikersaccount dat gemachtigd is om deze actie uit te voeren. Voer de vingerafdruk van het certificaat in.

Certificaten worden gebruikt in verificatie op basis van clientcertificaten. Ze kunnen alleen worden toegewezen aan lokale gebruikersaccounts; ze werken niet met domeinaccounts.

Als u een vingerafdruk van een certificaat wilt ophalen, gebruikt u de opdracht Get-Item of Get-ChildItem in het PowerShell-certificaat: station.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ComputerName

Hiermee geeft u de computer waarop de beheerbewerking moet worden uitgevoerd. De waarde kan een volledig gekwalificeerde domeinnaam, een NetBIOS-naam of een IP-adres zijn. Gebruik de naam van de lokale computer, gebruik localhost of gebruik een punt (.) om de lokale computer op te geven. De lokale computer is de standaardinstelling. Wanneer de externe computer zich in een ander domein bevindt dan de gebruiker, moet u een volledig gekwalificeerde domeinnaam gebruiken. U kunt een waarde voor deze parameter doorsluisen naar de cmdlet.

Type:	String
Aliassen:	CN
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ConnectionURI

Hiermee geeft u het verbindingseindpunt op. De notatie van deze tekenreeks is als volgt:

De volgende tekenreeks is een correct opgemaakte waarde voor deze parameter:

http://Server01:8080/WSMAN

De URI moet volledig gekwalificeerd zijn.

Type:	Uri
Aliassen:	CURI, CU
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. De standaardwaarde is de huidige gebruiker. Typ een gebruikersnaam, zoals User01, Domain01\User01 of User@Domain.com. U kunt ook een PSCredential--object invoeren, zoals een object dat wordt geretourneerd door de Get-Credential-cmdlet. Wanneer u een gebruikersnaam typt, wordt u door deze cmdlet gevraagd om een wachtwoord.

Type:	PSCredential
Aliassen:	cred, c
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Dialect

Hiermee geeft u het dialect te gebruiken in het filterpredicaat. Dit kan elk dialect zijn dat wordt ondersteund door de externe service. De volgende aliassen kunnen worden gebruikt voor de dialect-URI:

WQL-https://schemas.microsoft.com/wbem/wsman/1/WQL
Selector https://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
Koppelings-http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Type:	Uri
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Enumerate

Geeft aan dat deze cmdlet alle exemplaren van een beheerresource retourneert.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Filter

Hiermee geeft u de filterexpressie voor de opsomming. Als u deze parameter opgeeft, moet u ook Dialectopgeven.

De geldige waarden van deze parameter zijn afhankelijk van het dialect dat is opgegeven in Dialect. Als Dialect- bijvoorbeeld WQL is, moet de parameter Filter een tekenreeks bevatten en moet de tekenreeks een geldige WQL-query bevatten, zoals de volgende query:

"Select * from Win32_Service where State != Running"

Als Dialect koppeling is, moet filter een tekenreeks bevatten en moet de tekenreeks een geldig filter bevatten, zoals het volgende filter:

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

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Fragment

Hiermee geeft u een sectie in het exemplaar dat moet worden bijgewerkt of opgehaald voor de opgegeven bewerking. Als u bijvoorbeeld de status van een spooler-service wilt ophalen, geeft u het volgende op:

-Fragment Status

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-OptionSet

Hiermee geeft u een set switches naar een service om de aard van de aanvraag te wijzigen of verfijnen. Deze lijken op schakelopties die worden gebruikt in opdrachtregelshells omdat ze servicespecifiek zijn. U kunt een willekeurig aantal opties opgeven.

In het volgende voorbeeld ziet u de syntaxis die de waarden 1, 2 en 3 doorgeeft voor de parameters a, b en c:

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

Type:	Hashtable
Aliassen:	OS
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Port

Hiermee geeft u de poort op die moet worden gebruikt wanneer de client verbinding maakt met de WinRM-service. Wanneer het transport HTTP is, is de standaardpoort 80. Wanneer het transport HTTPS is, is de standaardpoort 443.

Wanneer u HTTPS als transport gebruikt, moet de waarde van de parameter ComputerName overeenkomen met de algemene naam (CN) van het servercertificaat. Als de parameter SkipCNCheck- echter is opgegeven als onderdeel van de parameter SessionOption, hoeft de algemene naam van het certificaat van de server niet overeen te komen met de hostnaam van de server. De parameter SkipCNCheck mag alleen worden gebruikt voor vertrouwde computers.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ResourceURI

Hiermee geeft u de URI van de resourceklasse of het exemplaar. De URI identificeert een specifiek type resource, zoals schijven of processen, op een computer.

Een URI bestaat uit een voorvoegsel en een pad van een resource. Bijvoorbeeld:

https://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
Aliassen:	RURI
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ReturnType

Hiermee geeft u het type gegevens dat moet worden geretourneerd. De acceptabele waarden voor deze parameter zijn:

Object
EPR
ObjectAndEPR

De standaardwaarde is Object.

Als u Object opgeeft of deze parameter niet opgeeft, retourneert deze cmdlet alleen objecten. Als u eindpuntverwijzing (EPR) opgeeft, retourneert deze cmdlet alleen de eindpuntverwijzingen van de objecten. Eindpuntverwijzingen bevatten informatie over de resource-URI en de selectors voor het exemplaar. Als u ObjectAndEPR opgeeft, retourneert deze cmdlet zowel het object als de bijbehorende eindpuntverwijzingen.

Type:	String
Aliassen:	RT
Geaccepteerde waarden:	object, epr, objectandepr
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SelectorSet

Hiermee geeft u een set waardeparen op die worden gebruikt om bepaalde beheerresource-exemplaren te selecteren. De parameter SelectorSet wordt gebruikt wanneer er meer dan één exemplaar van de resource bestaat. De waarde van de parameter SelectorSet moet een hash-tabel zijn.

In het volgende voorbeeld ziet u hoe u een waarde voor deze parameter invoert:

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

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SessionOption

Hiermee geeft u uitgebreide opties voor de WS-Management sessie. Voer een SessionOption--object in dat u maakt met behulp van de cmdlet New-WSManSessionOption. Typ Get-Help New-WSManSessionOptionvoor meer informatie over de beschikbare opties.

Type:	SessionOption
Aliassen:	SO
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Shallow

Geeft aan dat deze cmdlet alleen exemplaren retourneert van de basisklasse die is opgegeven in de resource-URI. Als u deze parameter niet opgeeft, retourneert deze cmdlet exemplaren van de basisklasse die is opgegeven in de URI en in alle afgeleide klassen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UseSSL

Hiermee geeft u op dat het SSL-protocol (Secure Sockets Layer) wordt gebruikt om een verbinding met de externe computer tot stand te brengen. SSL wordt standaard niet gebruikt.

WS-Management versleutelt alle Windows PowerShell-inhoud die via het netwerk wordt verzonden. Met de parameter UseSSL kunt u de extra beveiliging van HTTPS opgeven in plaats van HTTP. Als SSL niet beschikbaar is op de poort die wordt gebruikt voor de verbinding en u deze parameter opgeeft, mislukt de opdracht.

Type:	SwitchParameter
Aliassen:	SSL
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

None

Deze opdracht accepteert geen invoer.

Uitvoerwaarden

XmlElement

Met deze cmdlet wordt een XMLElement--object gegenereerd.

Delen via

Get-WSManInstance

Syntaxis

Description

Voorbeelden

Voorbeeld 1: Alle informatie ophalen uit WMI

Voorbeeld 2: De status van de Spooler-service ophalen

Voorbeeld 3: Eindpuntverwijzingen ophalen voor alle services

Voorbeeld 4: Services ophalen die voldoen aan opgegeven criteria

Voorbeeld 5: Listenerconfiguratie ophalen die overeenkomt met criteria op de lokale computer

Voorbeeld 6: Listenerconfiguratie ophalen die overeenkomt met criteria op een externe computer

Voorbeeld 7: Gekoppelde exemplaren ophalen die zijn gerelateerd aan een opgegeven instantie

Voorbeeld 8: Koppelingsexemplaren ophalen die zijn gerelateerd aan een opgegeven instantie

Parameters

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Invoerwaarden

Uitvoerwaarden

Aanvullende resources

Delen via

Get-WSManInstance

Syntaxis

Description

Voorbeelden

Voorbeeld 1: Alle informatie ophalen uit WMI

Voorbeeld 2: De status van de Spooler-service ophalen

Voorbeeld 3: Eindpuntverwijzingen ophalen voor alle services

Voorbeeld 4: Services ophalen die voldoen aan opgegeven criteria

Voorbeeld 5: Listenerconfiguratie ophalen die overeenkomt met criteria op de lokale computer

Voorbeeld 6: Listenerconfiguratie ophalen die overeenkomt met criteria op een externe computer

Voorbeeld 7: Gekoppelde exemplaren ophalen die zijn gerelateerd aan een opgegeven instantie

Voorbeeld 8: Koppelingsexemplaren ophalen die zijn gerelateerd aan een opgegeven instantie

Parameters

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Invoerwaarden

Uitvoerwaarden

Verwante koppelingen

Aanvullende resources