powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Disconnect-WSMan



NAME
Disconnect-WSMan

SYNOPSIS
Disconnects the client from the WinRM service on a remote computer.

SYNTAX
Disconnect-WSMan [-ComputerName ] []


DESCRIPTION
The Disconnect-WSMan cmdlet disconnects the client from the WinRM service on a remote computer. If you saved the WS
-Management session in a variable, the session object remains in the variable, but the state of the WS-Management s
ession is "Closed". You can use this cmdlet within the context of the WS-Management provider to disconnect the clie
nt from the WinRM service on a remote computer. However, you can also use this cmdlet to disconnect from the WinRM
service on remote computers before you change to the WS-Management provider.

For more information about how to connect to the WinRM service on a remote computer, see Connect-WSMan.


PARAMETERS
-ComputerName
Specifies the computer from which you want to disconnect. The value can be a fully qualified domain name, a Net
BIOS name, or an IP address. Use the local computer name, use localhost, or use a dot (.) to specify the local
computer. The local computer is the default. When the remote computer is in a different domain from the user, y
ou must use a fully qualified domain name must be used. You can pipe a value for this parameter to the cmdlet.


Note: You cannot disconnect from the local host (the default connection to the local computer). However, if a s
eparate connection is made to the local computer (for example, by using the computer name), you can remove that
connection by using the Disconnect-WSMan cmdlet .

Required? false
Position? named
Default value localhost
Accept pipeline input? false
Accept wildcard characters? false


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS
None
This cmdlet does not accept any input.


OUTPUTS
None
This cmdlet does not generate any output.


NOTES





-------------------------- EXAMPLE 1 --------------------------

C:\PS>Disconnect-WSMan -computer server01

C:\PS> cd WSMan:
PS WSMan:\>
PS WSMan:\> dir


WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName Type
------------ ----
localhost Container


Description
-----------
This command deletes the connection to the remote server01 computer.

This cmdlet is generally used within the context of the WS-Management provider to disconnect from a remote computer
, in this case the server01 computer. However, you can also use the Disconnect-WSMan cmdlet to remove connections t
o remote computers before you change to the WSMan provider. Those connections will not appear in the ComputerName
list.






RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkId=141439
Connect-WSMan
Disable-WSManCredSSP
Enable-WSManCredSSP
Get-WSManCredSSP
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
New-WSManSessionOption
Remove-WSManInstance
Set-WSManInstance
Set-WSManQuickConfig
Test-WSMan