Disconnect-WSMan

モジュール:: Microsoft.WSMan.Management Module

リモートコンピューター上の WinRM サービスからクライアントを切断します。

構文

Default (既定)

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

説明

Disconnect-WSMan コマンドレットは、リモートコンピューター上の WinRM サービスからクライアントを切断します。 WS-Management セッションを変数に保存した場合、セッションオブジェクトは変数に残りますが、WS-Management セッションの状態は [終了] になります。 WSMan プロバイダーのコンテキスト内でこのコマンドレットを使用して、リモートコンピューター上の WinRM サービスからクライアントを切断できます。ただし、WSMan プロバイダーに変更する前に、このコマンドレットを使用してリモートコンピューター上の WinRM サービスから切断することもできます。

リモートコンピューター上の WinRM サービスに接続する方法の詳細については、「 Connect-WSMan」を参照してください。

例

例 1: リモートコンピューターへの接続を削除する

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

このコマンドは、server01 という名前のリモートコンピューターへの接続を削除します。

このコマンドレットは、通常、WSMan プロバイダーのコンテキスト内でリモートコンピューター (この場合は server01 コンピューター) から切断するために使用されます。ただし、WSMan プロバイダーに変更する前に 、Disconnect-WSMan を使用してリモートコンピューターへの接続を削除することもできます。これらの接続は ComputerName の一覧には表示されません。

パラメーター

-ComputerName

管理操作を実行する対象のコンピューターを指定します。値には、完全修飾ドメイン名、NetBIOS 名、または IP アドレスを指定できます。ローカルコンピューター名を使用するか、localhost を使用するか、ドット (.) を使用してローカルコンピューターを指定します。ローカルコンピューターが既定です。リモートコンピューターがユーザーとは別のドメインにある場合は、完全修飾ドメイン名を使用する必要があります。このパラメーターの値をコマンドレットにパイプできます。

ローカルホストから切断することはできません。つまり、ローカルコンピューターへの既定の接続を切断することはできません。ただし、たとえば、コンピューター名を使用して、ローカルコンピューターへの別の接続を作成する場合。

パラメーターのプロパティ

型:	String
規定値:	Localhost
ワイルドカードのサポート:	False
DontShow:	False

パラメーターセット

(All)

配置:	0
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。詳細については、about_CommonParametersを参照してください。

次の方法で共有

Disconnect-WSMan

構文

Default (既定)

説明

例

例 1: リモート コンピューターへの接続を削除する