Stop-Computer

ローカル コンピューターとリモート コンピューターを停止 (シャットダウン) します。

構文

All

Stop-Computer
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-WsmanAuthentication <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Stop-Computer コマンドレットは、ローカル コンピューターとリモート コンピューターをシャットダウンします。

Stop-Computerのパラメーターを使用して、認証レベルと代替資格情報を指定し、即時シャットダウンを強制することができます。

PowerShell 7.1 では、linux および macOS 用に Stop-Computer が追加されました。 Windows以外のプラットフォームには、WhatIf、Confirm、およびCommonParameters パラメーターのみが含まれます。 このコマンドレットは、ネイティブ コマンド /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: ドメイン内のコンピューターをシャットダウンする

この例では、指定したドメイン内のすべてのコンピューターを強制的にシャットダウンします。

$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -Credential $c

Get-Content では、 Path パラメーターを使用して、ドメイン コンピューターの一覧を含む現在のディレクトリ内のファイルを取得します。 オブジェクトは、$s 変数に格納されます。

Get-Credential では、 Credential パラメーターを使用してドメイン管理者の資格情報を指定します。 資格情報は、 $c 変数に格納されます。

Stop-Computer は、 computerName パラメーターの $s 変数内のコンピューターの一覧で指定されたコンピューターをシャットダウンします。 Force パラメーターは、即時シャットダウンを強制します。 Credential パラメーターは、$c変数に保存された資格情報を送信します。

パラメーター

-ComputerName

停止するコンピューターを指定します。 既定値はローカル コンピューターです。

1 台以上のコンピューターの NETBIOS 名、IP アドレス、または完全修飾ドメイン名をコンマ区切りリストに入力します。 ローカル コンピューターを指定するには、コンピューター名または localhost を入力します。

このパラメーターは、PowerShell リモート処理には依存しません。 コンピューターがリモート コマンドを実行するように構成されていない場合でも、ComputerName パラメーターを使用できます。

このパラメーターは、Windows プラットフォームでのみ使用できます。

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

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False
エイリアス:CN(中国), __サーバー, [サーバー], IPアドレス

パラメーター セット

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

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

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

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
エイリアス:Cf

パラメーター セット

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

-Credential

このアクションを実行するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。

User01 や Domain01\User01などのユーザー名を入力するか、 コマンドレットによって生成された Get-Credential オブジェクトを入力します。 ユーザー名を入力すると、パスワードの入力を求められます。

資格情報は PSCredential オブジェクトに格納され、パスワードは SecureStringとして格納されます。

Note

SecureString データ保護についての詳細は、「SecureString はどのくらい安全ですか? 」を参照してください。.

このパラメーターは、Windows プラットフォームでのみ使用できます。

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

型:PSCredential
規定値:Current user
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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

-Force

コンピューターの即時シャットダウンを強制します。

このパラメーターは、Windows プラットフォームでのみ使用できます。

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

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

パラメーター セット

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

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

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

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
エイリアス:wi

パラメーター セット

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

-WsmanAuthentication

このコマンドレットが WSMan プロトコルを使用するときにユーザー資格情報を認証するために使用されるメカニズムを指定します。 既定値は Defaultです。

このパラメーターに使用できる値は次のとおりです。

  • Basic
  • CredSSP
  • デフォルト
  • ダイジェスト
  • Kerberos
  • 交渉。

このパラメーターの値の詳細については、「AuthenticationMechanism」を参照してください。

Caution

資格情報セキュリティ サービス プロバイダー (CredSSP) 認証は、ユーザー資格情報が認証されるリモート コンピューターに渡される認証で、リモート ネットワーク共有へのアクセスなど、複数のリソースで認証を必要とするコマンド用に設計されています。 このメカニズムにより、リモート操作のセキュリティ リスクが高まります。 リモート コンピューターが侵害された場合、それに渡される資格情報を使用してネットワーク セッションを制御できます。

このパラメーターは PowerShell 3.0 で導入されました。 このパラメーターは、Windows プラットフォームでのみ使用できます。

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

型:String
規定値:Default
指定可能な値:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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

CommonParameters

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

入力

None

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

出力

None

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

メモ

このコマンドレットでは、Win32_OperatingSystem WMI クラスの Win32Shutdown メソッドを使用します。 この方法では、マシンのシャットダウンに使用するユーザー アカウントに対して SeShutdownPrivilege 特権を有効にする必要があります。

PowerShell 7.1 では、linux および macOS 用に Stop-Computer が追加されました。 これらのプラットフォームの場合、コマンドレットはネイティブ コマンド /sbin/shutdownを呼び出します。