Freigeben über

Disconnect-WSMan

  • Referenz
Modul:
Microsoft.WSMan.Management

Trennt den Client vom WinRM-Dienst auf einem Remotecomputer.

Syntax

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

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das Disconnect-WSMan Cmdlet trennt den Client vom WinRM-Dienst auf einem Remotecomputer. Wenn Sie die WS-Management-Sitzung in einer Variablen gespeichert haben, bleibt das Sitzungsobjekt in der Variablen, aber der Zustand der WS-Management-Sitzung ist geschlossen. Sie können dieses Cmdlet im Kontext des WSMan-Anbieters verwenden, um den Client vom WinRM-Dienst auf einem Remotecomputer zu trennen. Sie können dieses Cmdlet jedoch auch verwenden, um die Verbindung mit dem WinRM-Dienst auf Remotecomputern zu trennen, bevor Sie zum WSMan-Anbieter wechseln.

Weitere Informationen zum Herstellen einer Verbindung mit dem WinRM-Dienst auf einem Remotecomputer finden Sie unter Connect-WSMan.

Beispiele

Beispiel 1: Löschen einer Verbindung mit einem Remotecomputer

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

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

Mit diesem Befehl wird die Verbindung mit dem Remotecomputer mit dem Namen "server01" gelöscht.

Dieses Cmdlet wird in der Regel im Kontext des WSMan-Anbieters verwendet, um eine Verbindung mit einem Remotecomputer zu trennen, in diesem Fall mit dem Computer server01. Sie können jedoch auch Disconnect-WSMan Verbindungen mit Remotecomputern entfernen, bevor Sie zum WSMan-Anbieter wechseln. Diese Verbindungen werden nicht in der ComputerName-Liste angezeigt.

Parameter

-ComputerName

Gibt den Computer an, auf dem der Verwaltungsvorgang ausgeführt werden soll. Bei dem Wert kann es sich um einen vollqualifizierten Domänennamen, einen NetBIOS-Namen oder eine IP-Adresse handeln. Verwenden Sie den lokalen Computernamen, verwenden Sie localhost, oder verwenden Sie einen Punkt (.), um den lokalen Computer anzugeben. Der lokale Computer ist die Standardeinstellung. Wenn sich der Remotecomputer in einer anderen Domäne als der Benutzer befindet, müssen Sie einen vollqualifizierten Domänennamen verwenden. Sie können einen Wert für diesen Parameter an das Cmdlet weiterreichen.

Sie können keine Verbindung mit dem lokalen Host herstellen. Das heißt, Sie können die Standardverbindung nicht mit dem lokalen Computer trennen. Wenn Sie jedoch eine separate Verbindung mit dem lokalen Computer erstellen, z. B. mithilfe des Computernamens.

Typ:String
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.