次の方法で共有


基本設定変数について

簡単な説明

PowerShell の動作をカスタマイズする変数。

長い説明

PowerShell には、その動作をカスタマイズできる一連の変数が含まれています。 これらの基本設定変数は、GUI ベースのシステムのオプションと同様に機能します。

基本設定変数は PowerShell オペレーティング環境に影響し、すべてのコマンドは環境内で実行されます。 多くの場合、コマンドレットには、特定のコマンドの基本設定動作をオーバーライドするために使用できるパラメーターがあります。

次の表に、基本設定変数とその既定値を示します。

変数 Default value
$ConfirmPreference
$DebugPreference SilentlyContinue
$ErrorActionPreference Continue
$ErrorView NormalView
$FormatEnumerationLimit 4
$InformationPreference SilentlyContinue
$LogCommandHealthEvent False (ログに記録されません)
$LogCommandLifecycleEvent False (ログに記録されません)
$LogEngineHealthEvent True (ログに記録)
$LogEngineLifecycleEvent True (ログに記録)
$LogProviderLifecycleEvent True (ログに記録)
$LogProviderHealthEvent True (ログに記録)
$MaximumAliasCount 4096
$MaximumDriveCount 4096
$MaximumErrorCount 256
$MaximumFunctionCount 4096
$MaximumHistoryCount 4096
$MaximumVariableCount 4096
$OFS (スペース文字 (" "))
$OutputEncoding ASCIIEncoding オブジェクト
$ProgressPreference 続行
$PSDefaultParameterValues (なし - 空のハッシュ テーブル)
$PSEmailServer (なし)
$PSModuleAutoLoadingPreference すべて
$PSSessionApplicationName Wsman
$PSSessionConfigurationName https://schemas.microsoft.com/PowerShell/microsoft.PowerShell
$PSSessionOption 「$PSSessionOption」を参照してください
$VerbosePreference SilentlyContinue
$WarningPreference Continue
$WhatIfPreference 0

PowerShell には、ユーザー設定を格納する次の環境変数が含まれています。 これらの環境変数の詳細については、「 about_Environment_Variables」を参照してください。

  • env:PSExecutionPolicyPreference
  • $env:PSModulePath

ユーザー設定変数の操作

このドキュメントでは、各基本設定変数について説明します。

特定のユーザー設定変数の現在の値を表示するには、変数の名前を入力します。 たとえば、次のコマンドは変数の値を $ConfirmPreference 表示します。

 $ConfirmPreference
High

変数の値を変更するには、代入ステートメントを使用します。 たとえば、次のステートメントはパラメーターの値を $ConfirmPreferenceMedium に変更します。

$ConfirmPreference = "Medium"

設定した値は、現在の PowerShell セッションに固有です。 すべての PowerShell セッションで変数を有効にするには、それらを PowerShell プロファイルに追加します。 詳細については、「about_Profiles」を参照してください。

リモートでの作業

リモート コンピューターでコマンドを実行する場合、リモート コマンドは、リモート コンピューターの PowerShell クライアントで設定された基本設定の対象となります。 たとえば、リモート コマンドを実行すると、リモート コンピューター $DebugPreference の変数の値によって、PowerShell がデバッグ メッセージにどのように応答するかが決まります。

リモート コマンドの詳細については、「 about_Remote」を参照してください。

$ConfirmPreference

コマンドレットまたは関数を実行する前に、PowerShell から確認を求めるメッセージが自動的に表示されるかどうかを指定します。

$ConfirmPreference変数の有効な値は、HighMedium、または Low です。 コマンドレットと関数には、 、または のリスクが割り当てられます。 変数の $ConfirmPreference 値がコマンドレットまたは関数に割り当てられたリスク以下の場合、PowerShell はコマンドレットまたは関数を実行する前に確認を求めるメッセージを自動的に表示します。

変数の値が None$ConfirmPreference場合、コマンドレットまたは関数を実行する前に PowerShell から自動的にプロンプトが表示されることはありません。

セッション内のすべてのコマンドレットと関数の確認動作を変更するには、変数の値を変更 $ConfirmPreference します。

1 つのコマンドの を $ConfirmPreference オーバーライドするには、コマンドレットまたは関数の Confirm パラメーターを使用します。 確認を要求するには、 を使用します -Confirm。 確認を抑制するには、 を使用します -Confirm:$false

の有効な値 $ConfirmPreference:

  • なし: PowerShell は自動的にプロンプトを表示しません。 特定のコマンドの確認を要求するには、コマンドレットまたは関数の Confirm パラメーターを使用します。
  • : 低、中、または高リスクのコマンドレットまたは関数を実行する前に、PowerShell で確認を求めるメッセージが表示されます。
  • : 中または高リスクのコマンドレットまたは関数を実行する前に、PowerShell で確認を求めるメッセージが表示されます。
  • 高: 危険度の高いコマンドレットまたは関数を実行する前に、PowerShell で確認を求めるメッセージが表示されます。

詳細な説明

PowerShell では、アクションを実行する前に確認を求めるメッセージが自動的に表示されます。 たとえば、コマンドレットまたは関数が、データを削除したり、大量のシステム リソースを使用したりするためにシステムに大きな影響を与える場合です。

Remove-Item -Path C:\file.txt
Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target "C:\file.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend
[?] Help (default is "Y"):

リスクの推定値は、 ConfirmImpact と呼ばれるコマンドレットまたは関数の属性です。 ユーザーはそれを変更することはできません。

システムにリスクをもたらす可能性のあるコマンドレットと関数には、1 つのコマンドの確認を要求または抑制するために使用できる Confirm パラメーターがあります。

ほとんどのコマンドレットと関数では、既定のリスク値 ConfirmImpact ( ) が使用され、既定値 $ConfirmPreferenceHigh であるため、自動確認はほとんど発生しません。 ただし、 の $ConfirmPreference 値を [中] または [ ] に変更することで、自動確認をアクティブ化できます。

この例では、変数$ConfirmPreference既定値 High の効果を示します。 [高] 値は、危険度の高いコマンドレットと関数のみを確認します。 ほとんどのコマンドレットと関数はリスクが中程度であるため、自動的には確認されず、 Remove-Item ファイルが削除されます。 コマンドに を追加 -Confirm すると、ユーザーに確認を求めるメッセージが表示されます。

$ConfirmPreference
High
Remove-Item -Path C:\temp1.txt

確認を要求するには、 を使用 -Confirm します。

Remove-Item -Path C:\temp2.txt -Confirm
Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target "C:\temp2.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend
[?] Help (default is "Y"):

次の例は、 の値を [中] に変更した場合の$ConfirmPreference効果を示しています。 ほとんどのコマンドレットと関数は中程度のリスクであるため、自動的に確認されます。 1 つのコマンドに対する確認プロンプトを表示しないようにするには、 Confirm パラメーターを使用し、 の $false値を指定します。

$ConfirmPreference = "Medium"
Remove-Item -Path C:\temp2.txt
Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target "C:\temp2.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend
[?] Help (default is "Y"):
Remove-Item -Path C:\temp3.txt -Confirm:$false

$DebugPreference

スクリプト、コマンドレット、プロバイダー、または Write-Debug コマンド ラインのコマンドによって生成されたデバッグ メッセージに対する PowerShell の応答方法を決定します。

一部のコマンドレットではデバッグ メッセージが表示されます。これは通常、プログラマやテクニカル サポートの専門家向けに設計された技術メッセージです。 既定では、デバッグ メッセージは表示されませんが、 の値 $DebugPreferenceを変更することでデバッグ メッセージを表示できます。

コマンドレットの Debug 共通パラメーターを使用して、特定のコマンドのデバッグ メッセージを表示または非表示にすることができます。 詳細については、「about_CommonParameters」を参照してください。

有効な値は次のとおりです。

  • 停止: デバッグ メッセージを表示し、実行を停止します。 コンソールにエラーを書き込みます。
  • Inquire: デバッグ メッセージを表示し、続行するかどうかを確認します。 デバッグ共通パラメーターをコマンドに追加すると、デバッグ メッセージを生成するようにコマンドが構成されると、変数の値が $DebugPreferenceInquire に変更されます。
  • 続行: デバッグ メッセージを表示し、実行を続行します。
  • SilentlyContinue: (既定値) 効果はありません。 デバッグ メッセージは表示されず、中断することなく実行が続行されます。

次の例は、コマンド ラインでコマンドを入力したときの の $DebugPreference 値を Write-Debug 変更する効果を示しています。 この変更は、コマンドレットとスクリプトによって生成されたメッセージを含むすべてのデバッグ メッセージに影響します。 例 では、1 つのコマンドに関連するデバッグ メッセージを表示または非表示にする Debug パラメーターを示します。

この例では、変数の $DebugPreference 既定値 SilentlyContinue の効果を示します。 既定では、 Write-Debug コマンドレットのデバッグ メッセージは表示されません。処理は続行されます。 Debug パラメーターを使用すると、1 つのコマンドの設定がオーバーライドされます。 ユーザーに確認を求めるメッセージが表示されます。

$DebugPreference
SilentlyContinue
Write-Debug -Message "Hello, World"
Write-Debug -Message "Hello, World" -Debug
DEBUG: Hello, World
Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
[?] Help (default is "Y"):

この例では、 の効果 $DebugPreferenceContinue 値を示します。 デバッグ メッセージが表示され、コマンドの処理が続行されます。

$DebugPreference = "Continue"
Write-Debug -Message "Hello, World"
DEBUG: Hello, World

この例では、 Debug パラメーターを値 が の $false 状態で使用して、1 つのコマンドのメッセージを抑制します。 デバッグ メッセージは表示されません。

Write-Debug -Message "Hello, World" -Debug:$false

この例では、Stop 値に設定した場合の$DebugPreference効果を示します。 デバッグ メッセージが表示され、コマンドが停止します。

$DebugPreference = "Stop"
Write-Debug -Message "Hello, World"
DEBUG: Hello, World
Write-Debug : The running command stopped because the preference variable
 "DebugPreference" or common parameter is set to Stop: Hello, World
At line:1 char:1
+ Write-Debug -Message "Hello, World"

この例では、 Debug パラメーターを値 が の $false 状態で使用して、1 つのコマンドのメッセージを抑制します。 デバッグ メッセージは表示されません。処理は停止されません。

Write-Debug -Message "Hello, World" -Debug:$false

次の $DebugPreference 使用例は、 Inquire 値に設定される効果を示しています。 デバッグ メッセージが表示され、ユーザーに確認を求められます。

$DebugPreference = "Inquire"
Write-Debug -Message "Hello, World"
DEBUG: Hello, World

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
[?] Help (default is "Y"):

この例では、 Debug パラメーターを値 が の $false 状態で使用して、1 つのコマンドのメッセージを抑制します。 デバッグ メッセージは表示されません。処理は続行されます。

Write-Debug -Message "Hello, World" -Debug:$false

$ErrorActionPreference

PowerShell が終了しないエラー (コマンドレットの処理を停止しないエラー) に応答する方法を決定します。 たとえば、コマンド ラインまたはスクリプト、コマンドレット、またはプロバイダーで、コマンドレットによって Write-Error 生成されたエラーなどです。

コマンドレットの ErrorAction 共通パラメーターを使用して、特定のコマンドの基本設定をオーバーライドできます。

有効な値は次のとおりです。

  • 停止: エラー メッセージを表示し、実行を停止します。
  • Inquire: エラー メッセージが表示され、続行するかどうかを確認するメッセージが表示されます。
  • 続行: (既定値) エラー メッセージが表示され、実行が続行されます。
  • 中断: ワークフロー ジョブを自動的に中断して、さらに調査できるようにします。 調査後、ワークフローを再開できます。
  • SilentlyContinue: 効果はありません。 エラー メッセージは表示されず、中断することなく実行が続行されます。
  • 無視: エラー メッセージを抑制し、コマンドの実行を続行します。 [無視] の値は、保存されたユーザー設定として使用されるのではなく、コマンドごとの使用を目的としています。 Ignore は変数の有効な値 $ErrorActionPreference ではありません。

および ErrorAction パラメーターは$ErrorActionPreference、コマンドレットの処理を停止する終了エラーに対する PowerShell の応答には影響しません。 ErrorAction 共通パラメーターの詳細については、「about_CommonParameters」を参照してください。

これらの例は、変数のさまざまな値の効果を $ErrorActionPreference 示しています。 ErrorAction パラメーターは、値をオーバーライド$ErrorActionPreferenceするために使用されます。

この例では、既定値の Continue$ErrorActionPreference示します。 終了しないエラーが生成されます。 メッセージが表示され、処理が続行されます。

PS> $ErrorActionPreference = "Continue"
PS> # Display the value of the preference.
PS> $ErrorActionPreference
Continue
PS> # Generate a non-terminating error.
PS> Write-Error -Message  "Hello, World"
Write-Error -Message  "Hello, World" : Hello, World
+ CategoryInfo          : NotSpecified: (:) [Write-Error],WriteErrorException
+ FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException
PS> # The error message is displayed and execution continues.
PS> # Use the ErrorAction parameter with a value of "SilentlyContinue".
PS> Write-Error -Message  "Hello, World" -ErrorAction:SilentlyContinue
PS> # The error message isn't displayed and execution continues.

この例では、設定を $ErrorActionPreferenceSilentlyContinue に示します。 エラー メッセージは抑制されます。

PS> # Display the value of the preference
PS> $ErrorActionPreference = "SilentlyContinue"
PS> # Generate an error message
PS> Write-Error -Message "Hello, World"
PS> # Error message is suppressed
PS> # Use the ErrorAction parameter with a value of "Continue"
PS> Write-Error -Message "Hello, World" -ErrorAction:Continue
Write-Error -Message "Hello, World" -ErrorAction:Continue : Hello, World
+ CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
+ FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

この例では、実際のエラーの影響を示します。 この場合、コマンドは存在しないファイル nofile.txtを取得します。

PS> # Display the value of the preference.
PS> $ErrorActionPreference
SilentlyContinue
PS> Get-ChildItem -Path C:\nofile.txt
PS> # Error message is suppressed.
PS> # Change the value to Continue.
PS> $ErrorActionPreference = "Continue"
PS> Get-ChildItem -Path C:\nofile.txt
Get-ChildItem : Cannot find path 'C:\nofile.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -Path C:\nofile.txt
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : ObjectNotFound: (C:\nofile.txt:String) [Get-ChildItem],
    ItemNotFoundException
+ FullyQualifiedErrorId : PathNotFound,Microsoft.PowerShell.Commands.
    GetChildItemCommand
PS> # Use the ErrorAction parameter
PS> Get-ChildItem -Path C:\nofile.txt -ErrorAction SilentlyContinue
PS> # Error message is suppressed.
PS> # Change the value to Inquire.
PS> $ErrorActionPreference = "Inquire"
PS> Get-ChildItem -Path C:\nofile.txt
Confirm
Cannot find path 'C:\nofile.txt' because it does not exist.
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
  [?] Help (default is "Y"): Y
Get-ChildItem : Cannot find path 'C:\nofile.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -Path C:\nofile.txt
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : ObjectNotFound: (C:\nofile.txt:String) [Get-ChildItem],
   ItemNotFoundException
+ FullyQualifiedErrorId : PathNotFound,Microsoft.PowerShell.Commands.
   GetChildItemCommand
PS> # Change the value to Continue.
PS> $ErrorActionPreference = "Continue"
PS> # Use the ErrorAction parameter to override the preference value.
PS> Get-Childitem C:\nofile.txt -ErrorAction "Inquire"
Confirm
Cannot find path 'C:\nofile.txt' because it does not exist.
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
  [?] Help (default is "Y"): Y
Get-Childitem : Cannot find path 'C:\nofile.txt' because it does not exist.
At line:1 char:1
+ Get-Childitem C:\nofile.txt -ErrorAction "Inquire"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : ObjectNotFound: (C:\nofile.txt:String) [Get-ChildItem],
   ItemNotFoundException
+ FullyQualifiedErrorId : PathNotFound,Microsoft.PowerShell.Commands.
   GetChildItemCommand

$ErrorView

PowerShell でのエラー メッセージの表示形式を決定します。

有効な値は次のとおりです。

  • NormalView: (既定値) ほとんどのユーザー向けに設計された詳細ビュー。 エラーの説明と、エラーに関連するオブジェクトの名前で構成されます。

  • CategoryView: 運用環境向けに設計された簡潔で構造化されたビュー。 その形式は次のとおりです。

    {Category}: ({TargetName}:{TargetType}):[{Activity}], {Reason}

CategoryView のフィールドの詳細については、「ErrorCategoryInfo クラス」を参照してください。

この例では、 の $ErrorView 値が既定の NormalView の場合にエラーがどのように表示されるかを示します。 Get-ChildItem は、存在しないファイルを検索するために使用されます。

Get-ChildItem -Path C:\nofile.txt
Get-ChildItem : Cannot find path 'C:\nofile.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -Path C:\nofile.txt

この例では、 の $ErrorView 値が CategoryView に変更されたときに、同じエラーがどのように表示されるかを示します。

$ErrorView = "CategoryView"
Get-ChildItem -Path C:\nofile.txt
ObjectNotFound: (C:\nofile.txt:String) [Get-ChildItem], ItemNotFoundException

この例では、 の $ErrorView 値がエラー表示にのみ影響することを示します。 自動変数に格納されている $Error エラー オブジェクトの構造は変更されません。 自動変数の $Error 詳細については、「 about_automatic_variables」を参照してください。

次のコマンドは、エラー配列要素 0 の最新のエラーに関連付けられている ErrorRecord オブジェクトを取得し、リスト内のすべてのエラー オブジェクトのプロパティを書式設定します。

$Error[0] | Format-List -Property * -Force
PSMessageDetails      :
Exception             : System.Management.Automation.ItemNotFoundException:
                          Cannot find path 'C:\nofile.txt' because it does
                          not exist.
                        at System.Management.Automation.SessionStateInternal.
                          GetChildItems(String path, Boolean recurse, UInt32
                          depth, CmdletProviderContext context)
                        at System.Management.Automation.ChildItemCmdlet
                          ProviderIntrinsics.Get(String path, Boolean
                          recurse, UInt32 depth, CmdletProviderContext context)
                        at Microsoft.PowerShell.Commands.GetChildItemCommand.
                          ProcessRecord()
TargetObject          : C:\nofile.txt
CategoryInfo          : ObjectNotFound: (C:\nofile.txt:String) [Get-ChildItem],
                          ItemNotFoundException
FullyQualifiedErrorId : PathNotFound,
                          Microsoft.PowerShell.Commands.GetChildItemCommand
ErrorDetails          :
InvocationInfo        : System.Management.Automation.InvocationInfo
ScriptStackTrace      : at <ScriptBlock>, <No file>: line 1
PipelineIterationInfo : {0, 1}

$FormatEnumerationLimit

ディスプレイに含まれる列挙項目の数を指定します。 この変数は、基になるオブジェクトには影響せず、表示にのみ影響します。 の $FormatEnumerationLimit 値が列挙項目の数より少ない場合、PowerShell は省略記号 (...) を追加して、アイテムが表示されないことを示します。

有効な値: 整数 (Int32)

既定値: 4

この例では、 変数を使用 $FormatEnumerationLimit して列挙項目の表示を改善する方法を示します。

この例のコマンドは、コンピューター上で実行されているすべてのサービスを 2 つのグループ (1 つは実行中のサービス、1 つは停止したサービス) で一覧表示するテーブルを生成します。 コマンドを Get-Service 使用してすべてのサービスを取得し、パイプライン経由で結果を コマンドレットに Group-Object 送信し、結果をサービスの状態別にグループ化します。

結果は、[ 名前] 列の状態と[ グループ ] 列のプロセスを一覧表示するテーブルです。 列ラベルを変更するには、ハッシュ テーブルを使用する方法については、「 about_Hash_Tables」を参照してください。 詳細については、「 Format-Table」の例を参照してください。

の現在の値を $FormatEnumerationLimit検索します。

$FormatEnumerationLimit
4

[状態] でグループ化されたすべてのサービスを一覧表示します。 各状態の [グループ] 列には最大 4 つのサービスが表示されます。値は 4 であるためです$FormatEnumerationLimit

Get-Service | Group-Object -Property Status
Count  Name       Group
-----  ----       -----
60     Running    {AdtAgent, ALG, Ati HotKey Poller, AudioSrv...}
41     Stopped    {Alerter, AppMgmt, aspnet_state, ATI Smart...}

一覧表示される項目の数を増やすには、 の $FormatEnumerationLimit 値を 1000 に増やします。 サービスを表示するには、 と Group-Object を使用Get-Serviceします。

$FormatEnumerationLimit = 1000
Get-Service | Group-Object -Property Status
Count  Name       Group
-----  ----       -----
60     Running    {AdtAgent, ALG, Ati HotKey Poller, AudioSrv, BITS, CcmExec...
41     Stopped    {Alerter, AppMgmt, aspnet_state, ATI Smart, Browser, CiSvc...

サービスの一覧を表示するには、Wrap パラメーターと共に を使用Format-Tableします。

Get-Service | Group-Object -Property Status | Format-Table -Wrap
Count  Name       Group
-----  ----       -----
60     Running    {AdtAgent, ALG, Ati HotKey Poller, AudioSrv, BITS, CcmExec,
                  Client for NFS, CryptSvc, DcomLaunch, Dhcp, dmserver,
                  Dnscache, ERSvc, Eventlog, EventSystem, FwcAgent, helpsvc,
                  HidServ, IISADMIN, InoRPC, InoRT, InoTask, lanmanserver,
                  lanmanworkstation, LmHosts, MDM, Netlogon, Netman, Nla,
                  NtLmSsp, PlugPlay, PolicyAgent, ProtectedStorage, RasMan,
                  RemoteRegistry, RpcSs, SamSs, Schedule, seclogon, SENS,
                  SharedAccess, ShellHWDetection, SMT PSVC, Spooler,
                  srservice, SSDPSRV, stisvc, TapiSrv, TermService, Themes,
                  TrkWks, UMWdf, W32Time, W3SVC, WebClient, winmgmt, wscsvc,
                  wuauserv, WZCSVC, zzInterix}

41     Stopped    {Alerter, AppMgmt, aspnet_state, ATI Smart, Browser, CiSvc,
                  ClipSrv, clr_optimization_v2.0.50727_32, COMSysApp,
                  CronService, dmadmin, FastUserSwitchingCompatibility,
                  HTTPFilter, ImapiService, Mapsvc, Messenger, mnmsrvc,
                  MSDTC, MSIServer, msvsmon80, NetDDE, NetDDEdsdm, NtmsSvc,
                  NVSvc, ose, RasAuto, RDSessMgr, RemoteAccess, RpcLocator,
                  SCardSvr, SwPrv, SysmonLog, TlntSvr, upnphost, UPS, VSS,
                  WmdmPmSN, Wmi, WmiApSrv, xmlprov}

$InformationPreference

$InformationPreference変数を使用すると、ユーザーに表示する情報ストリーム設定を設定できます。 具体的には、 Write-Information コマンドレットを追加してコマンドまたはスクリプトに追加した情報メッセージです。 InformationAction パラメーターを使用すると、その値によって変数の値が$InformationPreferenceオーバーライドされます。 Write-Information は PowerShell 5.0 で導入されました。

有効な値は次のとおりです。

  • 停止: コマンドが発生した時点で、コマンドまたはスクリプトを Write-Information 停止します。
  • Inquire: コマンドで指定した情報メッセージを Write-Information 表示し、続行するかどうかを確認します。
  • 続行: 情報メッセージを表示し、実行を続行します。
  • 中断: 続行する前にユーザーにメッセージを Write-Information 表示できるように、コマンドの実行後にワークフロー ジョブを自動的に中断します。 ワークフローは、ユーザーの判断で再開できます。
  • SilentlyContinue: (既定値) 効果はありません。 情報メッセージは表示されず、スクリプトは中断することなく続行されます。

$Log*イベント

Log*Event 基本設定変数は、イベント ビューアーで PowerShell イベント ログに書き込まれるイベントの種類を決定します。 既定では、エンジンとプロバイダーのイベントのみがログに記録されます。 ただし、 Log*Event 基本設定変数を使用して、コマンドに関するイベントのログ記録など、ログをカスタマイズできます。

Log*Event 基本設定変数は次のとおりです。

  • $LogCommandHealthEvent: コマンドの初期化と処理でエラーと例外をログに記録します。 既定値は $false (ログに記録されません) です。
  • $LogCommandLifecycleEvent: コマンドとコマンド パイプラインの開始と停止、およびコマンド検出のセキュリティ例外をログに記録します。 既定値は $false (ログに記録されません) です。
  • $LogEngineHealthEvent: セッションのエラーとエラーをログに記録します。 既定値は $true (ログに記録されます) です。
  • $LogEngineLifecycleEvent: セッションの開始と終了をログに記録します。 既定値は $true (ログに記録されます) です。
  • $LogProviderHealthEvent: 読み取りおよび書き込みエラー、参照エラー、呼び出しエラーなどのプロバイダー エラーをログに記録します。 既定値は $true (ログに記録されます) です。
  • $LogProviderLifecycleEvent: PowerShell プロバイダーの追加と削除をログに記録します。 既定値は $true (ログに記録されます) です。 PowerShell プロバイダーの詳細については、「 about_Providers」を参照してください。

Log*Event を有効にするには、 の値$trueを持つ変数を入力します。次に例を示します。

$LogCommandLifeCycleEvent = $true

イベントの種類を無効にするには、 の値 $falseを持つ変数を入力します。次に例を示します。

$LogCommandLifeCycleEvent = $false

有効にするイベントは、現在の PowerShell コンソールに対してのみ有効です。 構成をすべてのコンソールに適用するには、PowerShell プロファイルに変数設定を保存します。 詳細については、「about_Profiles」を参照してください。

$MaximumAliasCount

PowerShell セッションで許可されるエイリアスの数を決定します。 既定値は 4096 であり、ほとんどの使用に十分です。 ニーズに合わせて調整 $MaximumAliasCount できます。

有効な値: 1024 - 32768 (Int32)

既定値: 4096

システムのエイリアスをカウントするには、次のように入力します。

(Get-Alias).count

$MaximumDriveCount

特定のセッションで許可される PowerShell ドライブの数を決定します。 たとえば、PowerShell プロバイダーによって公開され、 ドライブや ドライブなどの Alias: ドライブとして表示されるファイル システム ドライブと HKLM: データ ストアなどです。

有効な値: 1024 - 32768 (Int32)

既定値: 4096

システムのエイリアスをカウントするには、次のように入力します。

(Get-PSDrive).count

$MaximumErrorCount

セッションのエラー履歴に保存されるエラーの数を指定します。

有効な値: 256 - 32768 (Int32)

既定値: 256

保持される各エラーを表すオブジェクトは、自動変数に $Error 格納されます。 $Error には、エラー レコード オブジェクトの配列が含まれています。 最新のエラーは、 配列内の最初のオブジェクトです $Error[0]

システムのエラーをカウントするには、配列の Count プロパティを$Error使用します。

$Error.count

特定のエラーを表示するには、配列表記を [0] 使用して最新のエラーを確認します。

$Error[0]

最も古い保持エラーを表示するには、次のように入力します。

$Error[($Error.Count -1]

Force パラメーターは、ErrorRecord オブジェクトの特殊な書式をオーバーライドし、従来の形式に戻します。 ErrorRecord オブジェクトのプロパティを表示するには、次のコマンドを入力します。

$Error[0] | Format-List -Property * -Force

この例では、 $Error.Count にエラーの数を表示します。 エラー履歴からすべてのエラーを削除するには、error 配列の メソッドを使用 Clear します。

$Error.Count
17
$Error.Clear()
$Error.Count
0

エラー配列のすべてのプロパティとメソッドを検索するには、InputObject パラメーターを指定して Get-Member コマンドレットを使用します。 InputObject パラメーターを使用すると、Get-Memberコレクションのプロパティとメソッドが表示されます。

Get-Member -InputObject $Error

オブジェクトのコレクションを にGet-MemberGet-Memberパイプすると、コレクション内のオブジェクトのプロパティとメソッドが表示されます。

$Error | Get-Member

$MaximumFunctionCount

特定のセッションで許可される関数の数を決定します。

有効な値: 1024 - 32768 (Int32)

既定値: 4096

セッションの関数を表示するには、PowerShell Function: プロバイダーによって公開されている PowerShell Function ドライブを使用します。 プロバイダーの Function 詳細については、「 」をabout_Function_Provider

現在のセッションの関数を一覧表示するには、次のように入力します。

Get-ChildItem Function:

現在のセッションの関数をカウントするには、次のように入力します。

(Get-ChildItem Function:).Count

$MaximumHistoryCount

現在のセッションのコマンド履歴に保存されるコマンドの数を指定します。

有効な値: 1 から 32768 (Int32)

既定値: 4096

コマンド履歴に現在保存されているコマンドの数を確認するには、次のように入力します。

(Get-History).Count

セッション履歴に保存されているコマンドを表示するには、 コマンドレットを Get-History 使用します。 詳細については、「 about_History」を参照してください。

$MaximumVariableCount

特定のセッションで許可される変数の数 (自動変数、基本設定変数、コマンドとスクリプトで作成する変数など) を決定します。

有効な値: 1024 - 32768 (Int32)

既定値: 4096

セッション内の変数を表示するには、コマンドレットと PowerShell ドライブと PowerShell Variable:Variable プロバイダーの機能を使用Get-Variableします。 詳細については、「 about_Variable_Provider」を参照してください。

システム上の変数の現在の数を検索するには、次のように入力します。

(Get-Variable).Count

$OFS

出力フィールド区切り文字 (OFS) は、文字列に変換される配列の要素を区切る文字を指定します。

有効な値: 任意の文字列。

既定値: スペース

既定では、変数は存在せず、 $OFS 出力ファイルの区切り記号はスペースですが、この変数を追加して任意の文字列に設定できます。 と入力$OFS="<value>"して、セッション内の の$OFS値を変更できます。

注意

スクリプト、モジュール、または構成出力でスペース (" ") の既定値が必要な場合は、既定値がコードの他の場所で変更されていないことに注意 $OFS してください。

次の例は、配列が文字列に変換されるときに、スペースを使用して値を区切る方法を示しています。 この場合、整数の配列が変数に格納され、変数が文字列としてキャストされます。

$array = 1,2,3,4
[string]$array
1 2 3 4

区切り記号を変更するには、値を $OFS 割り当てて変数を追加します。 変数には という名前を付 $OFSける必要があります。

$OFS = "+"
[string]$array
1+2+3+4

既定の動作を復元するには、 の値$OFSにスペース (" ") を割り当てるか、変数を削除します。 次のコマンドは、変数を削除し、区切り記号がスペースであることを確認します。

Remove-Variable OFS
[string]$array
1 2 3 4

$OutputEncoding

PowerShell が他のアプリケーションにテキストを送信するときに使用する文字エンコード 方法を決定します。

たとえば、アプリケーションが Unicode 文字列を PowerShell に返す場合は、文字を正しく送信するために値を UnicodeEncoding に変更する必要がある場合があります。

有効な値は、ASCIIEncodingSBCSCodePageEncodingUTF7Encoding、UTF8EncodingUTF32EncodingUnicodeEncoding などの Encoding クラスから派生したオブジェクトです。

既定値: ASCIIEncoding オブジェクト (System.Text.ASCIIEncoding)

この例では、Unicode 文字 (中国語など) を使用する言語にローカライズされたコンピューターで、PowerShell で Windows findstr.exe コマンドを動作させる方法を示します。

最初のコマンドは、 の値 $OutputEncodingを検索します。 値はエンコード オブジェクトであるため、 EncodingName プロパティのみを表示します。

$OutputEncoding.EncodingName

この例では、 findstr.exe コマンドを使用して、ファイル内に存在する 2 つの中国語文字を Test.txt 検索します。 この findstr.exe コマンドを Windows コマンド プロンプト (cmd.exe) で実行すると、テキスト ファイル内の文字 が検索findstr.exe 。 ただし、PowerShell で同じ findstr.exe コマンドを実行すると、文字は見つかりません。これは、PowerShell が Unicode テキストではなく ASCII テキストで findstr.exe に送信するためです。

findstr <Unicode-characters>

PowerShell でコマンドを機能させるには、 の $OutputEncoding 値をコンソールの OutputEncoding プロパティの値に設定します。これは、Windows 用に選択されているロケールに基づきます。 OutputEncoding はコンソールの静的プロパティであるため、 コマンドで二重コロン (::) を使用します。

$OutputEncoding = [console]::OutputEncoding
$OutputEncoding.EncodingName
OEM United States

エンコードの変更後、 findstr.exe コマンドは Unicode 文字を検索します。

findstr <Unicode-characters>
test.txt:         <Unicode-characters>

$ProgressPreference

Write-Progress コマンドレットによって生成された進行状況バーなど、スクリプト、コマンドレット、またはプロバイダーによって生成された進行状況の更新に対する PowerShell の応答方法を決定します。 コマンドレットは Write-Progress 、コマンドの状態を示す進行状況バーを作成します。

有効な値は次のとおりです。

  • 停止: 進行状況バーは表示されません。 代わりに、エラー メッセージが表示され、実行が停止されます。
  • お問い合わせ: 進行状況バーは表示されません。 続行するアクセス許可を求めるメッセージが表示されます。 または AY返信すると、進行状況バーが表示されます。
  • 続行: (既定値) 進行状況バーが表示され、実行が続行されます。
  • SilentlyContinue: コマンドを実行しますが、進行状況バーは表示されません。

$PSEmailServer

電子メール メッセージの送信に使用される既定の電子メール サーバーを指定します。 この基本設定変数は、 Send-MailMessage コマンドレットなどの電子メールを送信するコマンドレットで使用されます。

$PSDefaultParameterValues

コマンドレットと高度な関数のパラメーターの既定値を指定します。 の $PSDefaultParameterValues 値はハッシュ テーブルで、キーはコマンドレット名とパラメーター名で構成され、コロン (:) で区切られます。 値は、指定したカスタムの既定値です。

$PSDefaultParameterValues は PowerShell 3.0 で導入されました。

この基本設定変数の詳細については、「 about_Parameters_Default_Values」を参照してください。

$PSModuleAutoloadingPreference

セッション内のモジュールの自動インポートを有効または無効にします。 すべてが 既定値です。 変数の値に関係なく、 Import-Module を使用してモジュールをインポートできます。

有効な値は次のとおりです。

  • すべて: モジュールは初回使用時に自動的にインポートされます。 モジュールをインポートするには、モジュール内の任意のコマンドを取得または使用します。 たとえば、 Get-Commandを使用します。
  • ModuleQualified: モジュールは、ユーザーがモジュール内のコマンドのモジュール修飾名を使用する場合にのみ自動的にインポートされます。 たとえば、ユーザーが と入力 MyModule\MyCommandした場合、PowerShell は MyModule モジュールをインポートします。
  • なし: モジュールの自動インポートは、セッションで無効になります。 モジュールをインポートするには、 コマンドレットを使用します Import-Module

モジュールの自動インポートの詳細については、「 about_Modules」を参照してください。

$PSSessionApplicationName

Web Services for Management (WS-Management) テクノロジを使用するリモート コマンドの既定のアプリケーション名を指定します。 詳細については、「 Windows リモート管理について」を参照してください。

システムの既定のアプリケーション名は WSMANですが、この基本設定変数を使用して既定値を変更できます。

アプリケーション名は、接続 URI の最後のノードです。 たとえば、次のサンプル URI のアプリケーション名は です WSMAN

http://Server01:8080/WSMAN

既定のアプリケーション名は、リモート コマンドで接続 URI またはアプリケーション名が指定されていない場合に使用されます。

WinRM サービスは、アプリケーション名を使用して、接続要求をサービスするリスナーを選択します。 パラメーターの値は、リモート コンピューター上のリスナーの URLPrefix プロパティの値と一致する必要があります。

システムの既定値とこの変数の値をオーバーライドし、特定のセッションに別のアプリケーション名を選択するには、New-PSSession、Enter-PSSession、または Invoke-Command コマンドレットの ConnectionURI パラメーターまたは ApplicationName パラメーターを使用します。

$PSSessionApplicationNameユーザー設定変数はローカル コンピューターで設定されますが、リモート コンピューター上のリスナーを指定します。 指定したアプリケーション名がリモート コンピューターに存在しない場合、セッションを確立するコマンドは失敗します。

$PSSessionConfigurationName

現在のセッションで作成された PSSession に 使用される既定のセッション構成を指定します。

この基本設定変数はローカル コンピューターで設定されますが、リモート コンピューターにあるセッション構成を指定します。

変数の $PSSessionConfigurationName 値は、完全修飾リソース URI です。

既定値 https://schemas.microsoft.com/PowerShell/microsoft.PowerShell は、リモート コンピューター上の Microsoft.PowerShell セッション構成を示します。

構成名のみを指定した場合は、次のスキーマ URI が先頭に付加されます。

https://schemas.microsoft.com/PowerShell/

、、または Invoke-Command コマンドレットの ConfigurationName パラメーターを使用して、既定をオーバーライドし、特定のセッションに対して別のセッション構成をNew-PSSessionEnter-PSSession選択できます。

この変数の値はいつでも変更できます。 その場合は、選択したセッション構成がリモート コンピューターに存在する必要があります。 そうでない場合、セッション構成を使用するセッションを作成するコマンドは失敗します。

この基本設定変数は、リモート ユーザーがこのコンピューターに接続するセッションを作成するときに使用されるローカル セッション構成を決定しません。 ただし、ローカル セッション構成のアクセス許可を使用して、使用できるユーザーを決定できます。

$PSSessionOption

リモート セッションの高度なユーザー オプションの既定値を確立します。 これらのオプション設定は、セッション・オプションのシステムデフォルト値をオーバーライドします。

変数には $PSSessionOptionPSSessionOption オブジェクトが 含まれています。 詳細については、「 System.Management.Automation.Remoting.PSSessionOption」を参照してください。 オブジェクトの各プロパティは、セッション オプションを表します。 たとえば、 NoCompression プロパティは、セッション中にデータ圧縮を行います。

既定では、 $PSSessionOption 変数には PSSessionOption オブジェクトが含まれています。次に示すように、すべてのオプションの既定値が設定されています。

MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : None
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
IncludePortInSPN                  : False
OutputBufferingMode               : None
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         : 209715200
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : -00:00:00.0010000

これらのオプションの説明と詳細については、「 New-PSSessionOption」を参照してください。 リモート コマンドとセッションの詳細については、「 about_Remoteabout_PSSessions」を参照してください。

基本設定変数の値を $PSSessionOption 変更するには、 コマンドレットを New-PSSessionOption 使用して、好みのオプション値を使用して PSSessionOption オブジェクトを作成します。 という変数 $PSSessionOptionに出力を保存します。

$PSSessionOption = New-PSSessionOption -NoCompression

すべての PowerShell セッションで基本設定変数を $PSSessionOption 使用するには、変数を New-PSSessionOption 作成するコマンドを $PSSessionOption PowerShell プロファイルに追加します。 詳細については、「about_Profiles」を参照してください。

特定のリモート セッションのカスタム オプションを設定できます。 設定したオプションは、システムの既定値と基本設定変数の $PSSessionOption 値よりも優先されます。

カスタム セッション オプションを設定するには、 コマンドレットを New-PSSessionOption 使用して PSSessionOption オブジェクトを 作成します。 次に、セッションを作成するコマンドレット (、 などNew-PSSessionEnter-PSSession) の SessionOption パラメーターの値として PSSessionOption オブジェクトをInvoke-Command使用します。

$VerbosePreference

スクリプト、コマンドレット、またはプロバイダーによって生成された詳細メッセージ ( Write-Verbose コマンドレットによって生成されたメッセージなど) に PowerShell が応答する方法を決定します。 詳細メッセージは、コマンドを実行するために実行されるアクションを記述します。

既定では、詳細メッセージは表示されませんが、 の $VerbosePreference値を変更することでこの動作を変更できます。

コマンドレットの Verbose 共通パラメーターを使用して、特定のコマンドの詳細メッセージを表示または非表示にすることができます。 詳細については、「about_CommonParameters」を参照してください。

有効な値は次のとおりです。

  • 停止: 詳細メッセージとエラー メッセージを表示し、実行を停止します。
  • Inquire: 詳細メッセージを表示し、続行するかどうかを確認するプロンプトを表示します。
  • 続行: 詳細メッセージを表示し、実行を続行します。
  • SilentlyContinue: (既定値) 詳細メッセージは表示されません。 実行を続行します。

これらの例では、 のさまざまな値 $VerbosePreferenceVerbose パラメーターの効果を示して、基本設定の値をオーバーライドします。

この例では、 既定の SilentlyContinue 値の効果を示します。 コマンドは Message パラメーターを使用しますが、PowerShell コンソールにメッセージを書き込むわけではありません。

Write-Verbose -Message "Verbose message test."

Verbose パラメーターを使用すると、メッセージが書き込まれます。

Write-Verbose -Message "Verbose message test." -Verbose
VERBOSE: Verbose message test.

この例では、 Continue 値の効果を示します。 変数が $VerbosePreferenceContinue に設定され、メッセージが表示されます。

$VerbosePreference = "Continue"
Write-Verbose -Message "Verbose message test."
VERBOSE: Verbose message test.

この例では、 Continue 値をオーバーライドする の値 $false で Verbose パラメーターを使用 します。 メッセージは表示されません。

Write-Verbose -Message "Verbose message test." -Verbose:$false

この例では、 Stop 値の効果を示します。 変数が $VerbosePreferenceStop に設定され、メッセージが表示されます。 コマンドが停止しています。

$VerbosePreference = "Stop"
Write-Verbose -Message "Verbose message test."
VERBOSE: Verbose message test.
Write-Verbose : The running command stopped because the preference variable
  "VerbosePreference" or common parameter is set to Stop: Verbose message test.
At line:1 char:1
+ Write-Verbose -Message "Verbose message test."

この例では、Stop 値をオーバーライドする の値$falseを持つ Verbose パラメーターを使用します。 メッセージは表示されません。

Write-Verbose -Message "Verbose message test." -Verbose:$false

次の使用例は、 Inquire 値の効果を示しています。 変数は $VerbosePreferenceInquire に設定されます。 メッセージが表示され、ユーザーに確認を求められます。

$VerbosePreference = "Inquire"
Write-Verbose -Message "Verbose message test."
VERBOSE: Verbose message test.

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
[?] Help (default is "Y"):

この例では、Inquire 値をオーバーライドする の値$falseを持つ Verbose パラメーターを使用します。 ユーザーはメッセージを表示せず、メッセージは表示されません。

Write-Verbose -Message "Verbose message test." -Verbose:$false

$WarningPreference

スクリプト、コマンドレット、またはプロバイダーによって生成された警告メッセージ ( Write-Warning コマンドレットによって生成されたメッセージなど) に PowerShell が応答する方法を決定します。

既定では、警告メッセージが表示され、実行が続行されますが、 の $WarningPreference値を変更することでこの動作を変更できます。

コマンドレットの WarningAction 共通パラメーターを使用して、PowerShell が特定のコマンドからの警告にどのように応答するかを決定できます。 詳細については、「about_CommonParameters」を参照してください。

有効な値は次のとおりです。

  • 停止: 警告メッセージとエラー メッセージを表示し、実行を停止します。
  • Inquire: 警告メッセージを表示し、続行するアクセス許可を求めます。
  • 続行: (既定値) 警告メッセージが表示され、実行が続行されます。
  • SilentlyContinue: 警告メッセージは表示されません。 実行を続行します。

これらの例は、 のさまざまな値 $WarningPreferenceの効果を示しています。 WarningAction パラメーターは、ユーザー設定の値をオーバーライドします。

この例では、既定値の Continue の効果を示します。

$m = "This action can delete data."
Write-Warning -Message $m
WARNING: This action can delete data.

この例では、 WarningAction パラメーターと値 SilentlyContinue を使用して警告を抑制します。 メッセージは表示されません。

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction SilentlyContinue

次の使用例は、変数を $WarningPreferenceSilentlyContinue 値に変更します。 メッセージは表示されません。

$WarningPreference = "SilentlyContinue"
$m = "This action can delete data."
Write-Warning -Message $m

この例では、 WarningAction パラメーターを使用して、警告が生成されたときに停止します。

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction Stop
WARNING: This action can delete data.
Write-Warning : The running command stopped because the preference variable
  "WarningPreference" or common parameter is set to Stop:
    This action can delete data.
At line:1 char:1
+ Write-Warning -Message $m -WarningAction Stop

次の使用例は、変数を $WarningPreferenceInquire 値に変更します。 ユーザーに確認を求めるメッセージが表示されます。

$WarningPreference = "Inquire"
$m = "This action can delete data."
Write-Warning -Message $m
WARNING: This action can delete data.

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
[?] Help (default is "Y"):

この例では、 WarningAction パラメーターを 値 SilentlyContinue と共に使用します。 コマンドは引き続き実行され、メッセージは表示されません。

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction SilentlyContinue

次の使用例は、値を $WarningPreference Stop に変更 します

$WarningPreference = "Stop"
$m = "This action can delete data."
Write-Warning -Message $m
WARNING: This action can delete data.
Write-Warning : The running command stopped because the preference variable
  "WarningPreference" or common parameter is set to Stop:
    This action can delete data.
At line:1 char:1
+ Write-Warning -Message $m

この例では、 WarningActionInquire 値と共に使用します。 警告が発生すると、ユーザーにメッセージが表示されます。

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction Inquire
WARNING: This action can delete data.

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend
[?] Help (default is "Y"):

$WhatIfPreference

WhatIf をサポートするすべてのコマンドに対して自動的に有効にするかどうかを決定します。 WhatIf が有効になっている場合、コマンドレットはコマンドの期待される効果を報告しますが、コマンドは実行しません。

有効な値は次のとおりです。

  • False (0、無効): (既定値) WhatIf は自動的に有効になっていません。 手動で有効にするには、コマンドレットの WhatIf パラメーターを 使用します。
  • True (1、有効): WhatIf は、それをサポートするすべてのコマンドで自動的に有効になります。 ユーザーは、 WhatIf パラメーターを False の 値で使用して、手動で無効にすることができます (例: -WhatIf:$false)。

これらの例は、 のさまざまな値 $WhatIfPreferenceの効果を示しています。 WhatIf パラメーターを使用して、特定のコマンドの基本設定値をオーバーライドする方法を示します。

この例では、既定値 False に設定された $WhatIfPreference 変数の効果を示 します。 を使用して Get-ChildItem 、ファイルが存在することを確認します。 Remove-Item はファイルを削除します。 ファイルが削除されたら、 を使用して Get-ChildItem削除を確認できます。

Get-ChildItem -Path .\test.txt
Remove-Item -Path ./test.txt
    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           9/13/2019    10:53             10 test.txt
Get-ChildItem -Path .\test.txt
Get-ChildItem : Cannot find path 'C:\Test\test.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -File test.txt

この例では、 の値$WhatIfPreferenceが False の場合に WhatIf パラメーターを使用する効果を示します

ファイルが存在することを確認してください。

Get-ChildItem -Path .\test2.txt
    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/28/2019    17:06             12 test2.txt

WhatIf パラメーターを使用して、ファイルを削除しようとした結果を確認します。

Remove-Item -Path .\test2.txt -WhatIf
What if: Performing the operation "Remove File" on target "C:\Test\test2.txt".

ファイルが削除されなかったことを確認します。

Get-ChildItem -Path .\test2.txt
    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/28/2019    17:06             12 test2.txt

この例では、値 True に設定された$WhatIfPreference変数の効果を示します。 を使用 Remove-Item してファイルを削除すると、ファイルのパスが表示されますが、ファイルは削除されません。

ファイルの削除を試みます。 実行された場合 Remove-Item の動作に関するメッセージが表示されますが、ファイルは削除されません。

$WhatIfPreference = "True"
Remove-Item -Path .\test2.txt
What if: Performing the operation "Remove File" on target "C:\Test\test2.txt".

を使用して Get-ChildItem 、ファイルが削除されなかったことを確認します。

Get-ChildItem -Path .\test2.txt
    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/28/2019    17:06             12 test2.txt

この例では、 の $WhatIfPreference 値が True の場合にファイルを削除する方法を示します。 WhatIf パラメーターの値$falseは を使用します。 を使用して Get-ChildItem 、ファイルが削除されたことを確認します。

Remove-Item -Path .\test2.txt -WhatIf:$false
Get-ChildItem -Path .\test2.txt
Get-ChildItem : Cannot find path 'C:\Test\test2.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -Path .\test2.txt

WhatIf をサポートせず、WhatIfStop-Process をサポートするコマンドレットのGet-Process例を次に示します。 $WhatIfPreference変数の値は True です

Get-ProcessWhatIf をサポートしていません。 コマンドが実行されると、 Winword プロセスが表示されます。

Get-Process -Name Winword
 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
    130   119.84     173.38       8.39   15024   4 WINWORD

Stop-ProcessWhatIf をサポートしていますWinword プロセスは停止しません。

Stop-Process -Name Winword
What if: Performing the operation "Stop-Process" on target "WINWORD (15024)".

WhatIf の動作をStop-Processオーバーライドするには、WhatIf パラメーターの値$falseを に設定します。 Winword プロセスが停止しています。

Stop-Process -Name Winword -WhatIf:$false

Winword プロセスが停止したことを確認するには、 を使用Get-Processします。

Get-Process -Name Winword
Get-Process : Cannot find a process with the name "Winword".
  Verify the process name and call the cmdlet again.
At line:1 char:1
+ Get-Process -Name Winword

こちらもご覧ください

about_Automatic_Variables

about_CommonParameters

about_Environment_Variables

about_Profiles

about_Remote

about_Scopes

about_Variables