about_Operators
簡単な説明
PowerShell でサポートされる演算子について説明します。
長い説明
演算子は、コマンドまたは式で使用できる言語要素です。 PowerShell では、値の操作に役立ついくつかの種類の演算子がサポートされています。
算術演算子
算術演算子 (+
、-
*
、/
%
) を使用して、コマンドまたは式の値を計算します。 これらの演算子を使用すると、値を加算、減算、乗算、または除算し、除算演算の剰余 (剰余) を計算できます。
加算演算子は要素を連結します。 乗算演算子は、各要素の指定されたコピー数を返します。 算術演算子は、および Array などInt
String
DateTime
Hashtable
、それらを実装する任意の .NET 型で使用できます。
ビットごとの演算子 (-band
、-bor
-bxor
-bnot
、、-shl
-shr
) は、値のビット パターンを操作します。
詳細については、「 about_Arithmetic_Operators」を参照してください。
代入演算子
代入演算子 (=
、+=
-=
、*=
、/=
) %=
を使用して、変数に値を割り当てる、変更する、または追加します。 算術演算子と代入を組み合わせて、算術演算の結果を変数に割り当てることができます。
詳細については、「 about_Assignment_Operators」を参照してください。
比較演算子
値とテスト条件を比較するには、比較演算子 (-eq
、-gt
-ne
、、-lt
、、-le
) -ge
を使用します。 たとえば、2 つの文字列値を比較して、それらが等しいかどうかを判断できます。
比較演算子には、テキスト内のパターンを検索または置換する演算子も含まれます。 (-match
、、-notmatch
-replace
) 演算子は正規表現を使用し、(-like
、-notlike
) はワイルドカードを使用します*
。
包含比較演算子は、テスト値が参照セット (-in
、-notin
-contains
-notcontains
) に表示されるかどうかを判断します。
型比較演算子 (-is
、) は、 -isnot
オブジェクトが特定の型であるかどうかを判断します。
詳細については、「 about_Comparison_Operators」を参照してください。
論理演算子
論理演算子 (-and
、-or
-xor
、-not
!
) を使用して、条件付きステートメントを 1 つの複雑な条件に接続します。 たとえば、論理 -and
演算子を使用して、2 つの異なる条件を持つオブジェクト フィルターを作成できます。
詳細については、「 about_Logical_Operators」を参照してください。
リダイレクト演算子
リダイレクト演算子 (>
、2>>
>>
2>
、および 2>&1
) を使用して、コマンドまたは式の出力をテキスト ファイルに送信します。 リダイレクト演算子はコマンドレット (パラメーターなし) と同様に Out-File
機能しますが、エラー出力を指定されたファイルにリダイレクトすることもできます。 コマンドレットを使用して Tee-Object
出力をリダイレクトすることもできます。
詳細については、「about_Redirection」を参照してください。
分割演算子と結合演算子
演算子と -join
演算子は-split
、部分文字列を分割して結合します。 演算子は -split
、文字列を部分文字列に分割します。 演算子は -join
、複数の文字列を 1 つの文字列に連結します。
詳細については、「 about_Split と about_Join」を参照してください。
型演算子
型演算子 (-is
、、) を使用して、-isnot
-as
オブジェクトの.NET Framework型を検索または変更します。
詳細については、「 about_Type_Operators」を参照してください。
単項演算子
単項 ++
演算子と --
演算子を使用して、値をインクリメントまたはデクリメントし、 -
否定を行います。 たとえば、 から に変数$a
をインクリメントするには、「 」と入力します$a++
。10
9
詳細については、「 about_Arithmetic_Operators」を参照してください。
特殊演算子
特殊な演算子には、他の演算子グループに収まらない特定のユース ケースがあります。 たとえば、特殊な演算子を使用すると、コマンドを実行したり、値のデータ型を変更したり、配列から要素を取得したりできます。
グループ化演算子 ( )
他の言語と同様に、 (...)
は式の演算子の優先順位をオーバーライドします。 例: (1 + 2) / 3
ただし、PowerShell では、追加の動作があります。
(...)
を使用すると、 コマンド からの出力を式に参加させることができます。 例:PS> (Get-Item *.txt).Count -gt 10 True
パイプラインの最初のセグメントとして使用する場合、コマンドまたは式をかっこで囲むと、必ず式の結果が 列挙 されます。 かっこで コマンドをラップすると、結果がパイプラインを介して送信される前に 、メモリに収集 されたすべての出力が完了するまで実行されます。
Subexpression 演算子 $( )
1 つ以上のステートメントの結果を返します。 1 つの結果の場合、 はスカラーを返します。 複数の結果の場合、 は配列を返します。 これは、別の式内で式を使用する場合に使用します。 たとえば、コマンドの結果を文字列式に埋め込む場合です。
PS> "Today is $(Get-Date)"
Today is 12/02/2019 13:15:20
PS> "Folder list: $((dir c:\ -dir).Name -join ', ')"
Folder list: Program Files, Program Files (x86), Users, Windows
配列部分式演算子 @( )
1 つ以上のステートメントの結果を配列として返します。 結果は常に 0 個以上のオブジェクトの配列になります。
PS> $list = @(Get-Process | Select-Object -First 10; Get-Service | Select-Object -First 10 )
PS> $list.GetType()
IsPublic IsSerial Name BaseType
-------- -------- ---- --------
True True Object[] System.Array
PS> $list.Count
20
PS> $list = @(Get-Service | Where-Object Status -eq Starting )
PS> $list.GetType()
IsPublic IsSerial Name BaseType
-------- -------- ---- --------
True True Object[] System.Array
PS> $list.Count
0
ハッシュ テーブル リテラルの構文 @{}
配列部分式と同様に、この構文を使用してハッシュ テーブルを宣言します。 詳細については、「 about_Hash_Tables」を参照してください。
呼び出し演算子 &
コマンド、スクリプト、またはスクリプト ブロックを実行します。 呼び出し演算子 ("呼び出し演算子" とも呼ばれます) を使用すると、変数に格納され、文字列またはスクリプト ブロックで表されるコマンドを実行できます。 呼び出し演算子は、子スコープで実行されます。 スコープの詳細については、「 about_Scopes」を参照してください。
次の使用例は、コマンドを文字列に格納し、呼び出し演算子を使用して実行します。
PS> $c = "get-executionpolicy"
PS> $c
get-executionpolicy
PS> & $c
AllSigned
呼び出し演算子は文字列を解析しません。 つまり、呼び出し演算子を使用する場合、文字列内でコマンド パラメーターを使用することはできません。
PS> $c = "Get-Service -Name Spooler"
PS> $c
Get-Service -Name Spooler
PS> & $c
& : The term 'Get-Service -Name Spooler' is not recognized as the name of a
cmdlet, function, script file, or operable program. Check the spelling of
the name, or if a path was included, verify that the path is correct and
try again.
Invoke-Expression コマンドレットは、呼び出し演算子を使用するときに解析エラーを引き起こすコードを実行できます。
PS> & "1+1"
& : The term '1+1' is not recognized as the name of a cmdlet, function, script
file, or operable program. Check the spelling of the name, or if a path was
included, verify that the path is correct and try again.
At line:1 char:2
+ & "1+1"
+ ~~~~~
+ CategoryInfo : ObjectNotFound: (1+1:String) [], CommandNotFoundException
+ FullyQualifiedErrorId : CommandNotFoundException
PS> Invoke-Expression "1+1"
2
呼び出し演算子を使用して、ファイル名を使用してスクリプトを実行できます。 次の例は、スペースを含むスクリプト ファイル名を示しています。 スクリプトを実行しようとすると、代わりに、ファイル名を含む引用符で囲まれた文字列の内容が PowerShell に表示されます。 呼び出し演算子を使用すると、ファイル名を含む文字列の内容を実行できます。
PS C:\Scripts> Get-ChildItem
Directory: C:\Scripts
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 8/28/2018 1:36 PM 58 script name with spaces.ps1
PS C:\Scripts> ".\script name with spaces.ps1"
.\script name with spaces.ps1
PS C:\Scripts> & ".\script name with spaces.ps1"
Hello World!
スクリプト ブロックの詳細については、「 about_Script_Blocks」を参照してください。
Background 演算子 &
PowerShell ジョブで、バックグラウンドでパイプラインの前にパイプラインを実行します。 この演算子は、UNIX 制御演算子アンパサンド (&
) と同様に動作します。この操作は、コマンドをジョブとしてサブシェルで非同期的に実行する前に実行します。
この演算子は、機能的には と Start-Job
同等です。 既定では、バックグラウンド演算子は、並列タスクを開始した呼び出し元の現在の作業ディレクトリでジョブを開始します。 次の例は、バックグラウンド ジョブ演算子の基本的な使用方法を示しています。
Get-Process -Name pwsh &
このコマンドは、 の次の使用法と機能的に同等です Start-Job
。
Start-Job -ScriptBlock {Get-Process -Name pwsh}
と同様 Start-Job
に、バックグラウンド演算子は &
オブジェクトを Job
返します。 このオブジェクトは、ジョブの開始に使用した場合と同様に、 と Remove-Job
でReceive-Job
使用Start-Job
できます。
$job = Get-Process -Name pwsh &
Receive-Job $job -Wait
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
0 0.00 221.16 25.90 6988 988 pwsh
0 0.00 140.12 29.87 14845 845 pwsh
0 0.00 85.51 0.91 19639 988 pwsh
Remove-Job $job
&
バック グラウンド演算子は、UNIX コントロール演算子アンパサンド (&
) と同様に、ステートメント ターミネータでもあります。 これにより、バックグラウンド演算子の後に追加のコマンドを &
呼び出すことができます。 次の例では、バックグラウンド演算子の後に追加のコマンドを呼び出す方法を &
示します。
$job = Get-Process -Name pwsh & Receive-Job $job -Wait
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
0 0.00 221.16 25.90 6988 988 pwsh
0 0.00 140.12 29.87 14845 845 pwsh
0 0.00 85.51 0.91 19639 988 pwsh
これは、次のスクリプトと同じです。
$job = Start-Job -ScriptBlock {Get-Process -Name pwsh}
Receive-Job $job -Wait
複数のコマンドを実行する場合は、それぞれ独自のバックグラウンド プロセスで実行しますが、すべて 1 行に配置し、各コマンドの間と後に配置 &
するだけです。
Get-Process -Name pwsh & Get-Service -Name BITS & Get-CimInstance -ClassName Win32_ComputerSystem &
PowerShell ジョブの詳細については、「 about_Jobs」を参照してください。
キャスト演算子 [ ]
オブジェクトを指定した型に変換または制限します。 オブジェクトを変換できない場合、PowerShell はエラーを生成します。
[DateTime] '2/20/88' - [DateTime] '1/20/88' -eq [TimeSpan] '31'
キャストは、キャスト 表記を使用して変数が に割り当てられるときにも実行できます。
コンマ演算子 ,
二項演算子として、コンマは配列を作成するか、作成される配列に追加します。 式モードでは、単項演算子として、コンマは 1 つのメンバーのみを含む配列を作成します。 メンバーの前にコンマを置きます。
$myArray = 1,2,3
$SingleArray = ,1
Write-Output (,1)
は引数を受け取るので Write-Object
、式をかっこで囲む必要があります。
ドット ソーシング演算子 .
スクリプトを現在のスコープで実行して、スクリプトによって作成されるすべての関数、エイリアス、変数が現在のスコープに追加され、既存のスコープがオーバーライドされるようにします。 スクリプトによって宣言されたパラメーターが変数になります。 値が指定されていないパラメーターは、値のない変数になります。 ただし、自動変数 $args
は保持されます。
. c:\scripts\sample.ps1 1 2 -Also:3
注意
ドット ソーシング演算子の後にスペースが続きます。 スペースを使用して、現在のディレクトリを表すドット (.
) 記号とドットを区別します。
次の例では、現在のディレクトリ内の Sample.ps1 スクリプトが現在のスコープで実行されています。
. .\sample.ps1
書式演算子 -f
文字列オブジェクトの format メソッドを使用して文字列の書式を設定します。 演算子の左側に書式指定文字列を入力し、演算子の右側に書式設定するオブジェクトを入力します。
"{0} {1,-10} {2:N}" -f 1,"hello",[math]::pi
1 hello 3.14
書式設定された文字列で中かっこ ({}
) を保持する必要がある場合は、中かっこを 2 倍にすることでエスケープできます。
"{0} vs. {{0}}" -f 'foo'
foo vs. {0}
詳細については、「 String.Format メソッド」および 「複合書式」を参照してください。
Index 演算子 [ ]
配列やハッシュ テーブルなど、インデックス付きコレクションからオブジェクトを選択します。 配列インデックスは 0 から始まるため、最初のオブジェクトには として [0]
インデックスが付けられます。 負のインデックスを使用して、最後の値を取得することもできます。 ハッシュ テーブルは、キー値によってインデックスが作成されます。
インデックスのリストを指定すると、インデックス演算子は、それらのインデックスに対応するメンバーのリストを返します。
PS> $a = 1, 2, 3
PS> $a[0]
1
PS> $a[-1]
3
PS> $a[2, 1, 0]
3
2
1
(Get-HotFix | Sort-Object installedOn)[-1]
$h = @{key="value"; name="PowerShell"; version="2.0"}
$h["name"]
PowerShell
$x = [xml]"<doc><intro>Once upon a time...</intro></doc>"
$x["doc"]
intro
-----
Once upon a time...
オブジェクトがインデックス付きコレクションでない場合、index 演算子を使用して最初の要素にアクセスすると、オブジェクト自体が返されます。 最初の要素を超えるインデックス値は を返します $null
。
PS> (2)[0]
2
PS> (2)[-1]
2
PS> (2)[1] -eq $null
True
PS> (2)[0,0] -eq $null
True
パイプライン演算子 |
その前にあるコマンドの出力を、その後のコマンドに送信します ("pipes")。 出力に複数のオブジェクト ("コレクション") が含まれている場合、パイプライン演算子は一度に 1 つずつオブジェクトを送信します。
Get-Process | Get-Member
Get-Service | Where-Object {$_.StartType -eq 'Automatic'}
パイプライン チェーン演算子 &&
と ||
左側のパイプラインの成功に基づいて、右側のパイプラインを条件付きで実行します。
# If Get-Process successfully finds a process called notepad,
# Stop-Process -Name notepad is called
Get-Process notepad && Stop-Process -Name notepad
# If npm install fails, the node_modules directory is removed
npm install || Remove-Item -Recurse ./node_modules
詳細については、「 About_Pipeline_Chain_Operators」を参照してください。
範囲演算子 ..
上と下の境界を指定して、整数配列内の連続する整数を表します。
1..10
foreach ($a in 1..$max) {Write-Host $a}
範囲を逆の順序で作成することもできます。
10..1
5..-5 | ForEach-Object {Write-Output $_}
PowerShell 6 以降では、範囲演算子は 文字 と整数で動作 します。
文字の範囲を作成するには、境界文字を引用符で囲みます。
PS> 'a'..'f'
a
b
c
d
e
f
PS> 'F'..'A'
F
E
D
C
B
A
メンバー アクセス演算子 .
オブジェクトのプロパティとメソッドにアクセスします。 メンバー名には式を指定できます。
$myProcess.peakWorkingSet
(Get-Process PowerShell).kill()
'OS', 'Platform' | Foreach-Object { $PSVersionTable. $_ }
PowerShell 3.0 以降、メンバーを持たないリスト コレクション オブジェクトで 演算子を使用すると、PowerShell はそのコレクション内の項目を自動的に列挙し、それぞれの演算子を使用します。 詳細については、「 about_Member-Access_Enumeration」を参照してください。
静的メンバー演算子 ::
.NET Framework クラスの静的プロパティとメソッドを呼び出します。 オブジェクトの静的プロパティとメソッドを見つけるには、 コマンドレットの Static パラメーターを Get-Member
使用します。 メンバー名には式を指定できます。
[datetime]::Now
'MinValue', 'MaxValue' | Foreach-Object { [int]:: $_ }
三項演算子 ? <if-true> : <if-false>
単純な条件付きケースでは、 ステートメントの代わりに三項演算子を if-else
使用できます。
詳細については、「 about_If」を参照してください。
null 合体演算子 ??
null 合体演算子 ??
は、左側のオペランドが null でない場合に、左側のオペランドの値を返します。 それ以外の場合は、右側のオペランドを評価し、その結果を返します。 左側のオペランドが null 以外に評価された場合、??
演算子は右側のオペランドを評価しません。
$x = $null
$x ?? 100
100
次の例では、右側のオペランドは評価されません。
[string] $todaysDate = '1/10/2020'
$todaysDate ?? (Get-Date).ToShortDateString()
1/10/2020
null 合体代入演算子 ??=
null 合体代入演算子 ??=
は、左側のオペランドが null と評価された場合にのみ、右側のオペランドの値を左側のオペランドに代入します。 ??=
演算子では、左側のオペランドが null 値以外に評価された場合は、その右側のオペランドは評価されません。
$x = $null
$x ??= 100
$x
100
次の例では、右側のオペランドは評価されません。
[string] $todaysDate = '1/10/2020'
$todaysDate ??= (Get-Date).ToShortDateString()
1/10/2020
null 条件演算子 ?.
および ?[]
注意
この機能は、PowerShell 7.1 で試験段階からメインストリームに移行しました。
null 条件演算子は、そのオペランドが null 以外に評価される場合にのみ、メンバー アクセス ?.
、または要素アクセス ?[]
演算子をそのオペランドに適用します。それ以外の場合は、null を返します。
PowerShell では、変数名の一部として ?
が許可されるため、これらの演算子を使用するには、変数名の正式な仕様が必要です。 したがって、変数名は、${a}
や、?
が変数名 ${a?}
に含まれる場合のように、{}
で囲む必要があります。
次の例では、PropName の値が返されます。
$a = @{ PropName = 100 }
${a}?.PropName
100
次の例では、メンバー名 PropName へのアクセスを試みずに、null が返されます。
$a = $null
${a}?.PropName
同様に、要素の値が返されます。
$a = 1..10
${a}?[0]
1
オペランドが null の場合、要素にはアクセスされず、null が返されます。
$a = $null
${a}?[0]
注意
PowerShell では、変数名の一部として ?
が許可されるため、これらの演算子を使用するには、変数名の正式な仕様が必要です。 したがって、変数名は、${a}
や、?
が変数名 ${a?}
に含まれる場合のように、{}
で囲む必要があります。
変数名の構文 ${<name>}
を $()
部分式演算子と混同しないでください。 詳細については、「about_Variables」の変数名のセクションを参照してください。