Stop-Computer
ローカルとリモートのコンピューターを停止 (シャットダウン) します。
構文
Stop-Computer
[-WsmanAuthentication <String>]
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットは Stop-Computer
、ローカル コンピューターとリモート コンピューターをシャットダウンします。
パラメーター Stop-Computer
を使用して、認証レベルと代替資格情報を指定し、即時シャットダウンを強制することができます。
PowerShell 7.1 では、 Stop-Computer
Linux および macOS 用に追加されました。 これらのパラメーターは、これらのプラットフォームには影響しません。 このコマンドレットは、ネイティブ コマンドを呼び出す /sbin/shutdown
だけです。
例
例 1: ローカル コンピューターをシャットダウンする
次の使用例は、ローカル コンピューターをシャットダウンします。
Stop-Computer -ComputerName localhost
例 2: 2 台のリモート コンピューターとローカル コンピューターをシャットダウンする
次の使用例は、2 台のリモート コンピューターとローカル コンピューターを停止します。
Stop-Computer -ComputerName "Server01", "Server02", "localhost"
Stop-Computer
は ComputerName パラメーターを使用して、2 台のリモート コンピューターとローカル コンピューターを指定します。 各コンピューターがシャットダウンされます。
例 3: リモート コンピューターをバックグラウンド ジョブとしてシャットダウンする
この例では、 Stop-Computer
2 台のリモート コンピューターでバックグラウンド ジョブとして実行します。
バックグラウンド演算子 &
は、 Stop-Computer
バックグラウンド ジョブとしてコマンドを実行します。 詳細については、「about_Operators」を参照してください。
$j = Stop-Computer -ComputerName "Server01", "Server02" &
$results = $j | Receive-Job
$results
Stop-Computer
は ComputerName パラメーターを使用して、2 つのリモート コンピューターを指定します。 バックグラウンド演算子は &
、バックグラウンド ジョブとしてコマンドを実行します。 ジョブ オブジェクトは変数に $j
格納されます。
変数内の $j
ジョブ オブジェクトは、パイプラインの下に Receive-Job
送信され、ジョブの結果が取得されます。 オブジェクトは変数に $results
格納されます。 この変数は $results
、PowerShell コンソールにジョブ情報を表示します。
例 4: リモート コンピューターをシャットダウンする
この例では、指定した認証を使用してリモート コンピューターをシャットダウンします。
Stop-Computer -ComputerName "Server01" -WsmanAuthentication Kerberos
Stop-Computer
は ComputerName パラメーターを使用してリモート コンピューターを指定します。 WsmanAuthentication パラメーターは、Kerberos を使用してリモート接続を確立するように指定します。
例 5: Do でコンピューターをシャットダウンするメイン
この例では、指定した doメイン 内のすべてのコンピューターを強制的にシャットダウンします。
$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -Credential $c
Get-Content
は Path パラメーターを使用して、doメイン コンピューターの一覧を含む現在のディレクトリ内のファイルを取得します。 オブジェクトは変数に $s
格納されます。
Get-Credential
では、Credential パラメーターを使用して doメイン 管理者の資格情報を指定します。 資格情報は変数に $c
格納されます。
Stop-Computer
は、ComputerName パラメーターの変数内のコンピューターの一覧で指定されたコンピューターを$s
シャットダウンします。 Force パラメーターは、即時シャットダウンを強制します。 Credential パラメーターは、変数に保存された資格情報を$c
送信します。
パラメーター
-ComputerName
停止するコンピューターを指定します。 既定値はローカル コンピューターです。
コンマ区切りのリストで、1 台または複数のコンピューターの NETBIOS 名、IP アドレス、または完全修飾ドメイン名を入力します。 ローカル コンピューターを指定するには、コンピューター名または localhost を入力します。
このパラメーターは、PowerShell リモート処理には依存しません。 コンピューターがリモート コマンドを 実行するように構成されていない場合でも、ComputerName パラメーターを使用できます。
Type: | String[] |
Aliases: | CN, __SERVER, Server, IPAddress |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
このアクションを実行するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。
User01 や Doメイン01\User01 などのユーザー名を入力するか、コマンドレットによって生成された PSCredential オブジェクトをGet-Credential
入力します。 ユーザー名を入力すると、パスワードの入力を求められます。
資格情報は PSCredential オブジェクトに格納され、パスワードは SecureString として格納されます。
Note
SecureString データ保護の詳細については、「SecureString のセキュリティ保護方法」を参照してください。
Type: | PSCredential |
Position: | 1 |
Default value: | Current user |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
コンピューターの即時シャットダウンを強制します。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WsmanAuthentication
このコマンドレットが WSMan プロトコルを使用するときにユーザー資格情報を認証するために使用されるメカニズムを指定します。 既定値は Defaultです。
このパラメーターの有効値は、次のとおりです。
- 基本
- CredSSP
- 既定値
- Digest
- Kerberos
- 交渉。
このパラメーターの値の詳細については、「AuthenticationMechanism」を参照してください。
注意
資格情報セキュリティ サービス プロバイダー (CredSSP) 認証は、ユーザー資格情報が認証されるリモート コンピューターに渡される認証で、リモート ネットワーク共有へのアクセスなど、複数のリソースで認証を必要とするコマンド用に設計されています。 このメカニズムを使用すると、リモート操作のセキュリティ リスクが高まります。 リモート コンピューターのセキュリティが低下している場合は、そのリモート コンピューターに渡される資格情報を使用してネットワーク セッションが制御される場合があります。
このパラメーターは PowerShell 3.0 で導入されました。
Type: | String |
Accepted values: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
Position: | Named |
Default value: | Default |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
None
このコマンドレットにオブジェクトをパイプすることはできません。
出力
None
このコマンドレットは、出力を返しません。
メモ
このコマンドレットでは、次のコマンドを使用します。Win32Shutdown
WMI クラスのメソッド。Win32_OperatingSystem
この方法では、マシンの SeShutdownPrivilege
シャットダウンに使用するユーザー アカウントに対して特権を有効にする必要があります。
PowerShell 7.1 では、 Stop-Computer
Linux および macOS 用に追加されました。 これらのプラットフォームの場合、コマンドレットはネイティブ コマンドを呼び出します /sbin/shutdown
。
関連リンク
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示