Partager via

Disconnect-WSMan

  • Référence
Module:
Microsoft.WSMan.Management

Déconnecte le client du service WinRM sur un ordinateur distant.

Syntaxe

Disconnect-WSMan
          [[-ComputerName] <String>]
          [<CommonParameters>]

Description

L’applet Disconnect-WSMan de commande déconnecte le client du service WinRM sur un ordinateur distant. Si vous avez enregistré la session WS-Management dans une variable, l’objet de session reste dans la variable, mais l’état de la session WS-Management est fermé. Vous pouvez utiliser cette applet de commande dans le contexte du fournisseur WSMan pour déconnecter le client du service WinRM sur un ordinateur distant. Toutefois, vous pouvez également utiliser cette applet de commande pour vous déconnecter du service WinRM sur les ordinateurs distants avant de choisir le fournisseur WSMan.

Pour plus d’informations sur la connexion au service WinRM sur un ordinateur distant, consultez Connect-WSMan.

Exemples

Exemple 1 : Supprimer une connexion à un ordinateur distant

PS C:\> Disconnect-WSMan -computer server01
PS C:\> cd WSMan:
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container

Cette commande supprime la connexion à l’ordinateur distant nommé server01.

Cette applet de commande est généralement utilisée dans le contexte du fournisseur WSMan pour se déconnecter d'un ordinateur distant, dans ce cas l'ordinateur server01. Toutefois, vous pouvez également utiliser Disconnect-WSMan pour supprimer des connexions à des ordinateurs distants avant de passer au fournisseur WSMan. Ces connexions n’apparaissent pas dans la liste ComputerName.

Paramètres

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

Vous ne pouvez pas vous déconnecter de l’hôte local. Autrement dit, vous ne pouvez pas déconnecter la connexion par défaut à l’ordinateur local. Toutefois, si vous créez une connexion distincte à l’ordinateur local, par exemple en utilisant le nom de l’ordinateur.

Type:String
Position:0
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

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie.