Get-WSManInstance

Référence

Module:: Microsoft.WsMan.Management

Affiche les informations de gestion d’une instance de ressource spécifiée par un URI de ressource.

Syntaxe

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

L’applet de commande Get-WSManInstance récupère une instance d’une ressource de gestion spécifiée par un URI (Uniform Resource Identifier). Les informations récupérées peuvent être un jeu d’informations XML complexe, qui est un objet ou une valeur simple. Cette applet de commande équivaut à la commande Standard Web Services for Management (WS-Management) Get.

Cette applet de commande utilise la couche de connexion/de transport WS-Management pour récupérer des informations.

Exemples

Exemple 1 : Obtenir toutes les informations de 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

Cette commande retourne toutes les informations exposées par Windows Management Instrumentation (WMI) sur le service WinRM sur l’ordinateur serveur distant01.

Exemple 2 : Obtenir l’état du service Spooler

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

Cette commande retourne uniquement l’état du service du spouleur sur l’ordinateur serveur distant01.

Exemple 3 : Obtenir des références de point de terminaison pour tous les 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
...

Cette commande retourne des références de point de terminaison qui correspondent à tous les services sur l’ordinateur local.

Exemple 4 : Obtenir des services qui répondent aux critères spécifiés

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

Cette commande répertorie tous les services qui répondent aux critères suivants sur l’ordinateur Server01 distant :

Le type de démarrage du service est Automatique.
Le service est arrêté.

Exemple 5 : Obtenir la configuration de l’écouteur qui correspond aux critères sur l’ordinateur local

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

Cette commande répertorie la configuration de l’écouteur WS-Management sur l’ordinateur local de l’écouteur qui correspond aux critères du jeu de sélecteurs.

Exemple 6 : Obtenir la configuration de l’écouteur qui correspond aux critères sur un ordinateur distant

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

Cette commande répertorie la configuration de l’écouteur WS-Management sur l’ordinateur serveur distant01 pour l’écouteur qui correspond aux critères du jeu de sélecteurs.

Exemple 7 : Obtenir les instances associées à une instance spécifiée

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

Cette commande obtient les instances associées associées à l’instance spécifiée (winrm).

Vous devez placer le filtre entre guillemets, comme illustré dans l’exemple.

Exemple 8 : Obtenir des instances d’association liées à une instance spécifiée

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

Cette commande obtient des instances d’association liées à l’instance spécifiée (winrm). Étant donné que la valeur dialecte est association et que le paramètre associations est utilisé, cette commande retourne des instances d’association, et non des instances associées.

Vous devez placer le filtre entre guillemets, comme illustré dans l’exemple.

Paramètres

-ApplicationName

Spécifie le nom de l’application dans la connexion. La valeur par défaut du paramètre ApplicationName est WSMAN. L’identificateur complet du point de terminaison distant est au format suivant :

< >de transport ://<>serveur :<>de port /<> ApplicationName

Par exemple : http://server01:8080/WSMAN

Internet Information Services (IIS), qui héberge la session, transfère les requêtes avec ce point de terminaison à l’application spécifiée. Ce paramètre par défaut de WSMAN est approprié pour la plupart des utilisations. Ce paramètre est conçu pour être utilisé si de nombreux ordinateurs établissent des connexions à distance à un ordinateur exécutant PowerShell. Dans ce cas, les hôtes IIS WS-Management à des fins d’efficacité.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Associations

Indique que cette applet de commande obtient des instances d’association, et non des instances associées. Vous ne pouvez utiliser ce paramètre que lorsque le paramètre dialecte a la valeur Association.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Authentication

Spécifie le mécanisme d’authentification à utiliser sur le serveur. Les valeurs acceptables pour ce paramètre sont les suivantes :

Basique. De base est un schéma dans lequel le nom d’utilisateur et le mot de passe sont envoyés en texte clair au serveur ou au proxy.
Faire défaut. Utilisez la méthode d’authentification implémentée par le protocole WS-Management. Il s’agit de la valeur par défaut.
Digérer. Digest est un schéma de réponse aux défis qui utilise une chaîne de données spécifiée par le serveur pour le défi.
Kerberos. L’ordinateur client et le serveur s’authentifient mutuellement à l’aide de certificats Kerberos.
Négocier. Negotiate est un schéma de réponse aux défis qui négocie avec le serveur ou le proxy pour déterminer le schéma à utiliser pour l’authentification. Par exemple, cette valeur de paramètre permet de négocier si le protocole Kerberos ou NTLM est utilisé.
CredSSP. Utilisez l’authentification CredSSP (Credential Security Support Provider), qui permet à l’utilisateur de déléguer les informations d’identification. Cette option est conçue pour les commandes qui s’exécutent sur un ordinateur distant, mais collectent des données à partir ou exécutent des commandes supplémentaires sur d’autres ordinateurs distants.

Attention : CredSSP délègue les informations d’identification de l’utilisateur de l’ordinateur local à un ordinateur distant. Cette pratique augmente le risque de sécurité de l’opération à distance. Si l’ordinateur distant est compromis, lorsque les informations d’identification sont transmises, les informations d’identification peuvent être utilisées pour contrôler la session réseau.

Type:	AuthenticationMechanism
Alias:	auth, am
Valeurs acceptées:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-BasePropertiesOnly

Indique que cette applet de commande énumère uniquement les propriétés qui font partie de la classe de base spécifiée par le paramètre ResourceURI. Ce paramètre n’a aucun effet si le paramètre peu profond est spécifié.

Type:	SwitchParameter
Alias:	UBPO, Base
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-CertificateThumbprint

Spécifie le certificat de clé publique numérique (X509) d’un compte d’utilisateur autorisé à effectuer cette action. Entrez l’empreinte numérique du certificat.

Les certificats sont utilisés dans l’authentification basée sur les certificats client. Ils ne peuvent être mappés qu’à des comptes d’utilisateur locaux ; ils ne fonctionnent pas avec les comptes de domaine.

Pour obtenir une empreinte numérique de certificat, utilisez la commande Get-Item ou Get-ChildItem dans le lecteur PowerShell Cert : .

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ComputerName

Spécifie l’ordinateur sur lequel exécuter l’opération de gestion. La valeur peut être un nom de domaine complet, un nom NetBIOS ou une adresse IP. Utilisez le nom de l’ordinateur local, utilisez localhost ou utilisez un point (.) pour spécifier l’ordinateur local. L’ordinateur local est la valeur par défaut. Lorsque l’ordinateur distant se trouve dans un domaine différent de celui de l’utilisateur, vous devez utiliser un nom de domaine complet. Vous pouvez diriger une valeur pour ce paramètre vers l’applet de commande.

Type:	String
Alias:	CN
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ConnectionURI

Spécifie le point de terminaison de connexion. Le format de cette chaîne est le suivant :

< >de transport ://<Server>:<>de port /<Nom_application>

La chaîne suivante est une valeur correctement mise en forme pour ce paramètre :

http://Server01:8080/WSMAN

L’URI doit être complet.

Type:	Uri
Alias:	CURI, CU
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Credential

Spécifie un compte d’utilisateur autorisé à effectuer cette action. La valeur par défaut est l’utilisateur actuel. Tapez un nom d’utilisateur, tel que User01, Domain01\User01 ou User@Domain.com. Vous pouvez également entrer un objet PSCredential, tel qu’un objet retourné par l’applet de commande Get-Credential. Lorsque vous tapez un nom d’utilisateur, cette applet de commande vous invite à entrer un mot de passe.

Type:	PSCredential
Alias:	cred, c
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Dialect

Spécifie le dialecte à utiliser dans le prédicat de filtre. Il peut s’agir de n’importe quel dialecte pris en charge par le service distant. Les alias suivants peuvent être utilisés pour l’URI de dialecte :

WQL https://schemas.microsoft.com/wbem/wsman/1/WQL
Sélecteur https://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter d’association

Type:	Uri
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Enumerate

Indique que cette applet de commande retourne toutes les instances d’une ressource de gestion.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Filter

Spécifie l’expression de filtre pour l’énumération. Si vous spécifiez ce paramètre, vous devez également spécifier dialecte .

Les valeurs valides de ce paramètre dépendent du dialecte spécifié dans dialecte . Par exemple, si dialecte est WQL, le paramètre Filter doit contenir une chaîne, et la chaîne doit contenir une requête WQL valide telle que la requête suivante :

"Select * from Win32_Service where State != Running"

Si dialecte est Association, de filtre doit contenir une chaîne, et la chaîne doit contenir un filtre valide, tel que le filtre suivant :

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

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Fragment

Spécifie une section à l’intérieur de l’instance à mettre à jour ou à récupérer pour l’opération spécifiée. Par exemple, pour obtenir l’état d’un service de spouleur, spécifiez les éléments suivants :

-Fragment Status

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-OptionSet

Spécifie un ensemble de commutateurs vers un service pour modifier ou affiner la nature de la requête. Ces commutateurs ressemblent aux commutateurs utilisés dans les interpréteurs de commandes, car ils sont spécifiques au service. Vous pouvez spécifier n’importe quel nombre d’options.

L’exemple suivant illustre la syntaxe qui transmet les valeurs 1, 2 et 3 pour les paramètres a, b et c :

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

Type:	Hashtable
Alias:	OS
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Port

Spécifie le port à utiliser lorsque le client se connecte au service WinRM. Lorsque le transport est HTTP, le port par défaut est 80. Lorsque le transport est HTTPS, le port par défaut est 443.

Lorsque vous utilisez HTTPS comme transport, la valeur du paramètre ComputerName doit correspondre au nom commun du certificat (CN) du serveur. Toutefois, si le paramètre SkipCNCheck est spécifié dans le cadre du paramètre SessionOption, le nom commun du certificat du serveur n’a pas besoin de correspondre au nom d’hôte du serveur. Le paramètre SkipCNCheck doit être utilisé uniquement pour les ordinateurs approuvés.

Type:	Int32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceURI

Spécifie l’URI de la classe de ressource ou de l’instance. L’URI identifie un type spécifique de ressource, tel que des disques ou des processus, sur un ordinateur.

Un URI se compose d’un préfixe et d’un chemin d’accès d’une ressource. Par exemple:

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
Alias:	RURI
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ReturnType

Spécifie le type de données à retourner. Les valeurs acceptables pour ce paramètre sont les suivantes :

Objet
EPR
ObjectAndEPR

La valeur par défaut est Object.

Si vous spécifiez Object ou ne spécifiez pas ce paramètre, cette applet de commande retourne uniquement des objets. Si vous spécifiez la référence de point de terminaison (EPR), cette applet de commande retourne uniquement les références de point de terminaison des objets. Les références de point de terminaison contiennent des informations sur l’URI de ressource et les sélecteurs de l’instance. Si vous spécifiez ObjectAndEPR, cette applet de commande retourne à la fois l’objet et ses références de point de terminaison associées.

Type:	String
Alias:	RT
Valeurs acceptées:	object, epr, objectandepr
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-SelectorSet

Spécifie un ensemble de paires valeur utilisées pour sélectionner des instances de ressources de gestion particulières. Le paramètre SelectorSet est utilisé lorsque plusieurs instances de la ressource existent. La valeur du paramètre SelectorSet doit être une table de hachage.

L’exemple suivant montre comment entrer une valeur pour ce paramètre :

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

Type:	Hashtable
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-SessionOption

Spécifie les options étendues de la session WS-Management. Entrez un objet SessionOption que vous créez à l’aide de l’applet de commande New-WSManSessionOption. Pour plus d’informations sur les options disponibles, tapez Get-Help New-WSManSessionOption.

Type:	SessionOption
Alias:	SO
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Shallow

Indique que cette applet de commande retourne uniquement les instances de la classe de base spécifiées dans l’URI de ressource. Si vous ne spécifiez pas ce paramètre, cette applet de commande retourne des instances de la classe de base spécifiées dans l’URI et dans toutes ses classes dérivées.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-UseSSL

Spécifie que le protocole SSL (Secure Sockets Layer) est utilisé pour établir une connexion à l’ordinateur distant. Par défaut, SSL n’est pas utilisé.

WS-Management chiffre tout le contenu Windows PowerShell transmis sur le réseau. Le paramètre UseSSL vous permet de spécifier la protection supplémentaire du protocole HTTPS au lieu de HTTP. Si SSL n’est pas disponible sur le port utilisé pour la connexion et que vous spécifiez ce paramètre, la commande échoue.

Type:	SwitchParameter
Alias:	SSL
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

None

Cette commande n’accepte aucune entrée.

Sorties

XmlElement

Cette applet de commande génère un objet XMLElement.

Partager via

Get-WSManInstance

Syntaxe

Description

Exemples

Exemple 1 : Obtenir toutes les informations de WMI

Exemple 2 : Obtenir l’état du service Spooler

Exemple 3 : Obtenir des références de point de terminaison pour tous les services

Exemple 4 : Obtenir des services qui répondent aux critères spécifiés

Exemple 5 : Obtenir la configuration de l’écouteur qui correspond aux critères sur l’ordinateur local

Exemple 6 : Obtenir la configuration de l’écouteur qui correspond aux critères sur un ordinateur distant

Exemple 7 : Obtenir les instances associées à une instance spécifiée

Exemple 8 : Obtenir des instances d’association liées à une instance spécifiée

Paramètres

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Entrées

Sorties

Ressources supplémentaires

Partager via

Get-WSManInstance

Syntaxe

Description

Exemples

Exemple 1 : Obtenir toutes les informations de WMI

Exemple 2 : Obtenir l’état du service Spooler

Exemple 3 : Obtenir des références de point de terminaison pour tous les services

Exemple 4 : Obtenir des services qui répondent aux critères spécifiés

Exemple 5 : Obtenir la configuration de l’écouteur qui correspond aux critères sur l’ordinateur local

Exemple 6 : Obtenir la configuration de l’écouteur qui correspond aux critères sur un ordinateur distant

Exemple 7 : Obtenir les instances associées à une instance spécifiée

Exemple 8 : Obtenir des instances d’association liées à une instance spécifiée

Paramètres

-ApplicationName

-Associations

-Authentication

-BasePropertiesOnly

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-Enumerate

-Filter

-Fragment

-OptionSet

-Port

-ResourceURI

-ReturnType

-SelectorSet

-SessionOption

-Shallow

-UseSSL

Entrées

Sorties

Liens associés

Ressources supplémentaires