Connect-WSMan

構文

Connect-WSMan
       [-ApplicationName <String>]
       [[-ComputerName] <String>]
       [-OptionSet <Hashtable>]
        [-Port <Int32>]
       [-SessionOption <SessionOption>]
       [-UseSSL]
       [-Credential <PSCredential>]
        [-Authentication <AuthenticationMechanism>]
       [-CertificateThumbprint <String>]
       [<CommonParameters>]

Connect-WSMan
       [-ConnectionURI <Uri>]
       [-OptionSet <Hashtable>]
       [-Port <Int32>]
        [-SessionOption <SessionOption>]
       [-Credential <PSCredential>]
        [-Authentication <AuthenticationMechanism>]
       [-CertificateThumbprint <String>]
       [<CommonParameters>]

説明

Connect-WSMan コマンドレットは、リモート コンピューター上の WinRM サービスに接続し、リモート コンピューターへの永続的な接続を確立します。 WSMan プロバイダーのコンテキストでこのコマンドレットを使用して、リモート コンピューター上の WinRM サービスに接続できます。 ただし、WSMan プロバイダーに変更する前に、このコマンドレットを使用して、リモート コンピューター上の WinRM サービスに接続することもできます。 リモート コンピューターが WSMan プロバイダーのルート ディレクトリに表示されます。

クライアントとサーバー コンピューターが別のドメインまたはワークグループに属している場合は、明示的な資格情報が必要です。

リモート コンピューター上の WinRM サービスから切断する方法については、 Disconnect-WSMan コマンドレットを参照してください。

例

例 1: リモート コンピューターに接続する

PS C:\> Connect-WSMan -ComputerName "server01"
PS C:\> cd wsman:
PS WSMan:\>
PS WSMan:\> dir

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

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

このコマンドは、server01 リモート コンピューターへの接続を作成します。

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

例 2: 管理者資格情報を使用してリモート コンピューターに接続する

PS C:\> $cred = Get-Credential Administrator
PS C:\> Connect-WSMan -ComputerName "server01" -Credential $cred
PS C:\> cd wsman:
PS WSMan:\>
PS WSMan:\> dir

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

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

このコマンドは、管理者アカウントの資格情報を使用して、リモート システム server01 への接続を作成します。

最初のコマンドでは、Get-Credential コマンドレットを使用して管理者の資格情報を取得し、 $cred 変数に格納します。 Get-Credential では、システム レジストリの設定に応じて、ダイアログ ボックスまたはコマンド ラインでユーザー名とパスワードのパスワードの入力を求められます。

2 番目のコマンドでは、 Credential パラメーターを使用して、$credに格納されている資格情報を渡して Connect-WSManします。 Connect-WSMan 次に、管理者資格情報を使用してリモート システム サーバー 01 に接続します。

例 3: 指定したポートを介してリモート コンピューターに接続する

PS C:\> Connect-WSMan -ComputerName "server01" -Port 80
PS C:\> cd wsman:
PS WSMan:\>
PS WSMan:\> dir

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

このコマンドは、ポート 80 を介した server01 リモート コンピューターへの接続を作成します。

例 4: 接続オプションを使用してリモート コンピューターに接続する

PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS WSMan:\> dir

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

この例では、 New-WSManSessionOption コマンドで定義されている接続オプションを使用して、リモート サーバー 01 コンピューターへの接続を作成します。

最初のコマンドでは、 New-WSManSessionOption を使用して、接続設定オプションのセットを $a 変数に格納します。 この場合は、セッション オプションで接続のタイムアウトを 30 秒 (30,000 ミリ秒) に設定します。

2 番目のコマンドでは、 SessionOption パラメーターを使用して、 $a 変数に格納されている資格情報を渡して Connect-WSManします。 次 Connect-WSMan 、指定したセッション オプションを使用してリモート サーバー 01 コンピューターに接続します。

パラメーター

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-OptionSet

-Port

-SessionOption

-UseSSL

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

None

このコマンドレットは、出力を返しません。

メモ

WS-Management セッションを作成せずに、リモート コンピューターで管理コマンドを実行することや、管理データを照会することができます。 これを行うには、Invoke-WSManActionとGet-WSManInstanceの ComputerName パラメーターを使用します。 ComputerName パラメーターを使用すると、Windows PowerShell によって、1 つのコマンドに使用される一時的な接続が作成されます。 コマンドの実行後、その接続は閉じられます。

関連リンク

• Disable-WSManCredSSP
• Disconnect-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Get-WSManInstance
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption
• Remove-WSManInstance
• Set-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan