Get-WSManInstance

Spécifie le nom d'application de 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 :

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

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

Internet Information Services, qui héberge la session, transfère les demandes 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, IIS héberge WS-Management pour une efficacité.

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 Dialect a la valeur Association.

Spécifie le mécanisme d’authentification à utiliser au niveau du serveur. Les valeurs valides pour ce paramètre sont :

• Basic - 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.
• Default - Utilisez la méthode d’authentification implémentée par le protocole WS-Management. Il s’agit de la valeur par défaut.
• Digest - 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.
• Negotiate - Négocier 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 qui collectent des données ou exécutent des commandes supplémentaires à partir d'autres ordinateurs distants.

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

Spécifie le certificat de clé publique numérique (X509) d'un compte d'utilisateur qui a l'autorisation d'exécuter cette action. Entrez l’empreinte numérique du certificat.

Les certificats sont utilisés dans l'authentification par certificat client. Ils peuvent être mappés uniquement aux comptes d'utilisateur locaux ; ils ne fonctionnent pas avec les comptes de domaine.

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

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. Quand l'ordinateur distant est dans un domaine différent de celui de l'utilisateur, vous devez utiliser un nom de domaine complet. Vous pouvez acheminer par canal une valeur de ce paramètre vers l'applet de commande.

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

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

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

http://Server01:8080/WSMAN

L’URI doit être complet.

Spécifie un compte d’utilisateur qui a l’autorisation d’exécuter 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 Get-Credential commande. Lorsque vous tapez un nom d’utilisateur, cette applet de commande vous invite à entrer un mot de passe.

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

• WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
• Sélecteur- http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• Association- http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

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

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, filter 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\]}

Spécifie une section à l'intérieur de l'instance qui doit être mise à jour ou récupérée 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

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. N'importe quel nombre d'options peut être spécifié.

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

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

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 du serveur (CN). Toutefois, si le paramètre SkipCNCheck est spécifié dans le cadre du paramètre SessionOption , le nom commun du certificat du serveur ne doit pas correspondre au nom d’hôte du serveur. Le paramètre SkipCNCheck doit être utilisé uniquement pour les ordinateurs approuvés.

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 :

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

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

• Object
• EPR
• ObjectAndEPR

La valeur par défaut est Object.

Si vous spécifiez ou ne spécifiez Object 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 au point de terminaison contiennent des informations sur l'URI de ressource et les sélecteurs pour 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.

Spécifie un jeu de paires de 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 spécifier une valeur pour ce paramètre :

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

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.

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.

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.