Test-WSMan

Article
01/13/2010

Teste si le service WinRM s'exécute sur un ordinateur local ou distant.

Syntaxe

Test-WSMan [[-ComputerName] <string>] [-Authentication <Authentication>] [-Credential <PSCredential>] [<CommonParameters>]

Description

L'applet de commande Test-WSMan envoie une demande d'identification qui détermine si le service WinRM est en cours d'exécution sur un ordinateur local ou distant. Si l'ordinateur testé exécute le service, l'applet de commande affiche le schéma d'identité de la Gestion des services Web, la version du protocole, le revendeur du produit et la version de produit du service testé.

Paramètres

-Authentication <Authentication>

Spécifie le mécanisme d'authentification à utiliser au niveau du serveur. Les valeurs possibles sont les suivantes :

- Basic : Basic est un modèle dans lequel le nom d'utilisateur et le mot de passe sont envoyés en clair au serveur ou au proxy.

- Default : utilise la méthode d'authentification implémentée par le protocole Gestion des services Web.

- Digest : Digest est un modèle de stimulation/réponse qui utilise une chaîne de données spécifiée par le serveur pour la stimulation.

- Kerberos : l'ordinateur client et le serveur s'authentifient mutuellement à l'aide de certificats Kerberos.

- Negotiate : Negotiate est un modèle de stimulation/réponse qui négocie avec le serveur ou le proxy pour déterminer le modèle à utiliser pour l'authentification. Par exemple, cette valeur de paramètre permet la négociation pour déterminer si le protocole Kerberos ou NTLM est utilisé.

- CredSSP : l'authentification CredSSP (Credential Security Service Provider) permet à l'utilisateur de déléguer des informations d'identification. Cette option est conçue pour les commandes qui s'exécutent sur un seul ordinateur distant, mais qui collectent des données à partir d'autres ordinateurs distants ou qui 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 distante. Si l'ordinateur distant n'est pas fiable, lorsque les informations d'identification lui sont passées, elles peuvent être utilisées pour contrôler la session réseau.

Important : si le paramètre d'authentification n'est pas spécifié, la demande Test-WSMan sera envoyée anonymement (sans utiliser l'authentification) à l'ordinateur distant. Si la demande Test-WSMan est faite anonymement, elle ne retourne aucune information spécifique à la version du système d'exploitation. Au lieu de cela, Test-WSMan affiche des valeurs Null pour la version du système d'exploitation et le niveau de Service Pack (OS: 0.0.0 SP: 0.0).

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-ComputerName <string>

Spécifie l'ordinateur sur lequel vous voulez 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, localhost ou 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 l'utilisateur, vous devez utiliser un nom de domaine complet.

Obligatoire ?	false
Position ?	1
Valeur par défaut	localhost
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Credential <PSCredential>

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 « Utilisateur01 », « Domaine01\Utilisateur01 » ou « Utilisateur@Domaine.com ». Vous pouvez également entrer un objet PSCredential, tel que celui retourné par l'applet de commande Get-Credential. Lorsque vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

Aucun

Cette applet de commande n'accepte aucune entrée.

Sorties

Aucun

Cette applet de commande ne génère aucun objet de sortie.

Remarques

Par défaut, l'applet de commande Test-WSMan interroge le service WinRM sans utiliser l'authentification, et elle ne retourne aucune information spécifique à la version du système d'exploitation. Au lieu de cela, elle affiche des valeurs Null pour la version du système d'exploitation et le niveau de Service Pack (OS: 0.0.0 SP: 0.0).

Exemple 1

C:\PS>test-wsman

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 0.0.0 SP: 0.0 Stack: 2.0

Description
-----------
Cette commande détermine si le service WinRM est en cours d'exécution sur l'ordinateur local ou sur un ordinateur distant.

Exemple 2

C:\PS>test-wsman -computername server01

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 0.0.0 SP: 0.0 Stack: 2.0

Description
-----------
Cette commande détermine si le service WinRM est en cours d'exécution sur l'ordinateur nommé server01.

Exemple 3

C:\PS>test-wsman -authentication default

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 6.0.6001 SP: 1.0 Stack: 2.0

Description
-----------
Cette commande effectue un test pour voir si le service Gestion des services Web (WinRM) est en cours d'exécution sur l'ordinateur local à l'aide du paramètre d'authentification.

L'utilisation du paramètre d'authentification permet à l'applet de commande Test-WSMan de retourner la version du système d'exploitation.

Exemple 4

C:\PS>test-wsman -computername server01 -authentication default

wsmid           : http://schemas.dmtf.org/wbem/wsman/identity/1/wsmanidentity.xsd
ProtocolVersion : http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
ProductVendor   : Microsoft Corporation
ProductVersion  : OS: 6.1.7021 SP: 0.0 Stack: 2.0

Description
-----------
Cette commande effectue un test pour voir si le service Gestion des services Web (WinRM) est en cours d'exécution sur l'ordinateur nommé server01 à l'aide du paramètre d'authentification.

L'utilisation du paramètre d'authentification permet à l'applet de commande Test-WSMan de retourner la version du système d'exploitation.

Voir aussi

Concepts

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

Partager via