winrs コマンドを使用した Windows リモート管理では、プログラムをリモートで管理および実行できます。
Syntax
winrs [/<parameter>[:<value>]] <command>
Parameters
| Parameter | Description |
|---|---|
| /remote:<エンドポイント> | NetBIOS 名または標準接続を使用してターゲット エンドポイントを指定します。 - <URL>: [<トランスポート>://]<ターゲット>[:<ポート>] 指定しない場合は、 /r:localhost が使用されます。 |
| /unencrypted | リモート シェルへのメッセージが暗号化されないことを指定します。 このパラメータは、トラブルシューティングや、ネットワークトラフィックが ipsec を使用してすでに暗号化されている場合、または物理的なセキュリティが適用されている場合に役立ちます。 既定では、メッセージは Kerberos または NTLM キーを使用して暗号化されます。 このコマンドライン オプションは、HTTPS トランスポートが選択されている場合は無視されます。 |
| /username:<ユーザー名> | コマンドラインでのユーザー名を指定します。 指定しない場合、ツールではネゴシエート認証を使用するか、名前を入力するように求めます。 /username を指定する場合は、/password も指定する必要があります。 |
| /password:<パスワード> | コマンドラインでのパスワードを指定します。 /password が指定されていないが、/username が指定されている場合、ツールはパスワードの入力を求めます。 /password を指定する場合は、/username も指定する必要があります。 |
| /timeout:<秒> | このオプションは非推奨です。 |
| /directory:<パス> | リモート シェルの開始ディレクトリを指定します。 指定しない場合、リモートシェルは、環境変数 %USERPROFILE%で定義されたユーザーのホームディレクトリで起動します。 |
| /environment:<文字列>=<値> | シェルの起動時に設定される単一の環境変数を指定します。これにより、シェルの既定の環境を変更できます。 複数の環境変数を指定するには、このスイッチを複数回使用する必要があります。 |
| /noecho | エコーを無効にするように指定します。 noecho は、リモート プロンプトに対するユーザーの回答がローカルに表示されないようにするために必要になることがあります。 既定では、echo はオンになっています。 |
| /noprofile | ユーザーのプロファイルを読み込まないように指定します。 既定では、サーバーではユーザープロファイルの読み込みが試みられます。 リモート ユーザーがターゲット システムのローカル管理者でない場合は、このオプションが必要になります (既定ではエラーが発生します)。 |
| /allowdelegate | ユーザーの資格情報をリモート共有 (たとえば、ターゲット エンドポイントとは異なるコンピューター) にアクセスするために使用できることを指定します。 |
| /compression | 圧縮をオンにします。 リモート マシン上の古いインストールでは圧縮がサポートされていない可能性があります。 リモート マシン上の古いインストールでは圧縮がサポートされていない可能性があるないため、既定の設定はオフです。 |
| /usessl | リモート エンドポイントを使用するときに、SSL 接続を使用します。 トランスポート https: の代わりに SSL を指定すると、既定の WinRM 既定のポートが使用されます。 |
| /? | コマンド プロンプトにヘルプを表示します。 |
Remarks
- すべてのコマンドライン オプションでは、短い形式と長い形式のいずれかを受け入れます。 たとえば、 /r と /remote の両方が有効です。
- /remote コマンドを終了するには、リモート シェルに送信される Ctrl-C または Ctrl-break を入力します。 2 番目の Ctrl-C は、 winrs.exeを強制的に終了します。
- アクティブなリモート シェルまたは winrs 構成を管理するには、WinRM ツールを使用します。 アクティブなシェルを管理するための URI エイリアスは shell/cmd です。 winrs 構成の URI エイリアスは winrm/config/winrs です。
Examples
winrs /r:https://contoso.com command
winrs /r:contoso.com /usessl command
winrs /r:myserver command
winrs /r:http://127.0.0.1 command
winrs /r:http://169.51.2.101:80 /unencrypted command
winrs /r:https://[::FFFF:129.144.52.38] command
winrs /r:http://[1080:0:0:0:8:800:200C:417A]:80 command
winrs /r:https://contoso.com /t:600 /u:administrator /p:$%fgh7 ipconfig
winrs /r:myserver /env:path=^%path^%;c:\tools /env:TEMP=d:\temp config.cmd
winrs /r:myserver netdom join myserver /domain:testdomain /userd:johns /passwordd:$%fgh789
winrs /r:myserver /ad /u:administrator /p:$%fgh7 dir \\anotherserver\share