Freigeben über


Disconnect-WSMan

Trennt den Client vom WinRM-Dienst auf einem Remotecomputer.

Syntax

Default (Standard)

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

Beschreibung

Das cmdlet Disconnect-WSMan cmdlet trennt den Client vom WinRM-Dienst auf einem Remotecomputer. Wenn Sie die WS-Management Sitzung in einer Variablen gespeichert haben, verbleibt das Sitzungsobjekt in der Variablen, der Status der WS-Management Sitzung ist jedoch 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:\>
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 die Verbindung von einem Remotecomputer zu trennen, in diesem Fall der Server01-Computer. Sie können jedoch auch Disconnect-WSMan- verwenden, um Verbindungen mit Remotecomputern zu 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. Der Wert kann ein vollqualifizierter Domänenname, ein NetBIOS-Name oder eine IP-Adresse sein. Verwenden Sie den namen des lokalen Computers, verwenden Sie localhost, oder verwenden Sie einen Punkt (.), um den lokalen Computer anzugeben. Der lokale Computer ist der Standardwert. Wenn sich der Remotecomputer in einer anderen Domäne des Benutzers befindet, müssen Sie einen vollqualifizierten Domänennamen verwenden. Sie können einen Wert für diesen Parameter an das Cmdlet weiterleiten.

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.

Parametereigenschaften

Typ:String
Standardwert:Localhost
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Dieses Cmdlet nimmt keine Eingabe an.

Ausgaben

None

Dieses Cmdlet generiert keine Ausgabe.