about_Operators

[アーティクル]
03/21/2022

簡単な説明

PowerShell でサポートされている演算子について説明します。

長い説明

演算子は、コマンドまたは式で使用できる言語要素です。 PowerShell では、値の操作に役立ついくつかの種類の演算子がサポートされています。

算術演算子

算術演算子 ( + 、 / - * 、、、 % ) を使用して、コマンドまたは式の値を計算します。これらの演算子を使用すると、値の加算、減算、乗算、除算を行ったり、除算演算の剰余 (剰余) を計算したりすることができます。

加算演算子は要素を連結します。乗算演算子は、各要素の指定された数のコピーを返します。算術演算子は、、 String DateTime Hashtable 、、、およびの各配列を実装 Int するすべての .net 型で使用できます。

ビットごとの演算子 ( -band 、 -bor -bxor 、、 -bnot -shl 、、 -shr ) は、値のビットパターンを操作します。

詳細については、「 about_Arithmetic_Operators」を参照してください。

代入演算子

代入演算子 ( = 、 += -= 、、 *= /= 、、 %= ) を使用して、変数に値を代入、変更、または追加します。算術演算子を代入と組み合わせて、算術演算の結果を変数に代入することができます。

詳細については、「 about_Assignment_Operators」を参照してください。

比較演算子

比較演算子 ( -eq 、 -ne -gt 、、 -lt -le 、、 -ge ) を使用して、値とテスト条件を比較します。たとえば、2つの文字列値を比較して、両者が等しいかどうかを判断できます。

比較演算子には、テキストのパターンを検索または置換する演算子も含まれます。 ( -match , -notmatch , -replace ) 演算子は、正規表現を使用し、( -like , -notlike ) ワイルドカード * を使用します。

コンテインメント比較演算子は、テスト値が参照セット ( -in 、 -notin -contains 、、 -notcontains ) に表示されるかどうかを決定します。

型の比較演算子 ( -is , -isnot ) は、オブジェクトが特定の型であるかどうかを判断します。

詳細については、「 about_Comparison_Operators」を参照してください。

論理演算子

論理演算子 ( -and 、 -not -or -xor 、、、 ! ) を使用して、条件付きステートメントを1つの複雑な条件付きステートメントに接続します。たとえば、論理 -and 演算子を使用すると、2つの異なる条件を持つオブジェクトフィルターを作成できます。

詳細については、「 about_Logical_Operators」を参照してください。

リダイレクト演算子

コマンドまたは式の出力をテキストファイルに送信するには、リダイレクト演算子 ( > 、 >> 2> 、、 2>> 、および 2>&1 ) を使用します。リダイレクト演算子はコマンドレットの Out-File ように機能しますが (パラメーターなし)、指定されたファイルにエラー出力をリダイレクトすることもできます。コマンドレットを使用して、 Tee-Object 出力をリダイレクトすることもできます。

詳細については、「」を参照してください about_Redirection

Split 演算子と Join 演算子

演算子と -join 演算子は、 -split サブストリングを分割して結合します。演算子は -split 、文字列を部分文字列に分割します。演算子は、複数の文字列を連結して -join 1 つの文字列にします。

詳細については、「 about_Split 」および「 about_Join」を参照してください。

型演算子

オブジェクトの .NET Framework 型を検索または変更するには、型演算子 ( -is 、 -isnot 、 -as ) を使用します。

詳細については、「 about_Type_Operators」を参照してください。

単項演算子

単項 ++ 演算子と -- 演算子を使用して、値を - 加算またはデクリメントし、を否定します。たとえば、変数 $a をから 9 に 10 インクリメントするには、「」と入力 $a++ します。

詳細については、「 about_Arithmetic_Operators」を参照してください。

特別な演算子

特別な演算子には、他のどのオペレーターグループにも適合しない特定のユースケースがあります。たとえば、特殊な演算子を使用すると、コマンドの実行、値のデータ型の変更、または配列からの要素の取得を行うことができます。

グループ化演算子 `( )`

他の言語と同様に、は (...) 式の演算子の優先順位をオーバーライドします。例: (1 + 2) / 3

ただし、PowerShell には追加の動作があります。

(...)コマンド からの出力を式に参加させることができます。次に例を示します。
```
PS> (Get-Item *.txt).Count -gt 10
True
```
パイプラインの最初のセグメントとして使用する場合は、コマンドまたは式をかっこで囲むことで、式の結果を列挙することができます。かっこによって コマンド がラップされている場合は、パイプラインを介して結果が送信される前に、 メモリに収集 されたすべての出力を使用して完了します。

部分式演算子 `$( )`

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」を参照してください。

Call 演算子 `&`

コマンド、スクリプト、またはスクリプトブロックを実行します。呼び出し演算子 ("呼び出し演算子" とも呼ばれます) を使用すると、変数に格納され、文字列またはスクリプトブロックによって表されるコマンドを実行できます。呼び出し演算子は、子スコープで実行されます。スコープの詳細については、「 about_Scopes」を参照してください。

この例では、コマンドを文字列に格納し、call 演算子を使用して実行します。

PS> $c = "get-executionpolicy"
PS> $c
get-executionpolicy
PS> & $c
AllSigned

呼び出し演算子は、文字列を解析しません。これは、call 演算子を使用するときに、文字列内のコマンドパラメーターを使用できないことを意味します。

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.

呼び出し演算子を使用すると、解析エラーを発生させるコードを実行できます。

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

Call 演算子を使用して、ファイル名を使用してスクリプトを実行できます。次の例では、スペースを含むスクリプトファイル名を示しています。スクリプトを実行しようとすると、PowerShell によって、ファイル名を含む引用符で囲まれた文字列の内容が表示されます。 Call 演算子を使用すると、ファイル名を含む文字列の内容を実行できます。

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 制御演算子アンパサンド ( & ) と同様に動作し、subshell でジョブとして非同期にコマンドを実行します。

この演算子は、機能的に Start-Job はと同等です。既定では、バックグラウンド操作は、並列タスクを開始した呼び出し元の現在の作業ディレクトリ内のジョブを開始します。次の例は、バックグラウンドジョブオペレーターの基本的な使用方法を示しています。

Get-Process -Name pwsh &

このコマンドは、の Start-Job 次の使用方法と機能的には同等です。

Start-Job -ScriptBlock {Get-Process -Name pwsh}

と Start-Job 同様に、background 演算子は & オブジェクトを Job 返します。このオブジェクトは、ジョブの開始に使用 Start-Job した場合と同じように、および Remove-Job で Receive-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」を参照してください。

Cast 演算子 `[ ]`

オブジェクトを指定した型に変換または制限します。オブジェクトを変換できない場合は、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

Format 演算子 `-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}

詳細については、「 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

パイプライン演算子 `|`

このコマンドの前に続くコマンドの出力を ("パイプ" で) 送信します。出力に複数のオブジェクト ("コレクション") が含まれている場合、パイプライン演算子はオブジェクトを一度に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 クラスの静的プロパティおよびメソッドを呼び出します。オブジェクトの静的なプロパティとメソッドを検索するには、コマンドレットの Get-Member static パラメーターを使用します。メンバー名は式にすることができます。

[datetime]::Now
'MinValue', 'MaxValue' | Foreach-Object { [int]:: $_ }

三項演算子 `? <if-true> : <if-false>`

単純な条件付きケースでは、ステートメントの if-else 代わりに三項演算子を使用できます。

詳細については、「 about_If」を参照してください。

Null 合体演算子 `??`

null 合体演算子 ?? は、左側のオペランドが null でない場合に、左側のオペランドの値を返します。それ以外の場合は、右側のオペランドを評価し、その結果を返します。左側のオペランドが null 以外に評価された場合、?? 演算子は右側のオペランドを評価しません。

$x = $null
$x ?? 100

次の例では、右側のオペランドは評価されません。

[string] $todaysDate = '1/10/2020'
$todaysDate ?? (Get-Date).ToShortDateString()

1/10/2020

Null 合体代入演算子 `??=`

Null 合体代入演算子 ??= は、左側のオペランドが null と評価された場合にのみ、右側のオペランドの値を左側のオペランドに代入します。 ??= 演算子では、左側のオペランドが null 値以外に評価された場合は、その右側のオペランドは評価されません。

$x = $null
$x ??= 100
$x

次の例では、右側のオペランドは評価されません。

[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

次の例では、メンバー名 PropName にアクセスしないで、null を返します。

$a = $null
${a}?.PropName

同様に、要素の値が返されます。

$a = 1..10
${a}?[0]

オペランドが null の場合、要素はアクセスされず、null が返されます。

$a = $null
${a}?[0]

注意

の変数名の ${<name>} 構文は、部分式演算子と $() 混同しないようにしてください。詳細については、「 about_Variables」の「変数名」セクションを参照してください。

about_Operators

簡単な説明

長い説明

算術演算子

代入演算子

比較演算子

論理演算子

リダイレクト演算子

Split 演算子と Join 演算子

型演算子

単項演算子

特別な演算子

グループ化演算子 `( )`

部分式演算子 `$( )`

配列の部分式演算子 `@( )`

ハッシュテーブルリテラルの構文 `@{}`

Call 演算子 `&`

Background 演算子 `&`

Cast 演算子 `[ ]`

コンマ演算子 `,`

ドットソーシング演算子 `.`

Format 演算子 `-f`

Index 演算子 `[ ]`

パイプライン演算子 `|`

パイプラインチェーン演算子 `&&` と `||`

範囲演算子 `..`

メンバーアクセス演算子 `.`

静的メンバー演算子 `::`

三項演算子 `? <if-true> : <if-false>`

Null 合体演算子 `??`

Null 合体代入演算子 `??=`

Null 条件演算子 `?.` と `?[]`

関連項目

フィードバック

about_Operators

簡単な説明

長い説明

算術演算子

代入演算子

比較演算子

論理演算子

リダイレクト演算子

Split 演算子と Join 演算子

型演算子

単項演算子

特別な演算子

グループ化演算子 ( )

部分式演算子 $( )

配列の部分式演算子 @( )

ハッシュテーブルリテラルの構文 @{}

Call 演算子 &

Background 演算子 &

Cast 演算子 [ ]

コンマ演算子 ,

ドットソーシング演算子 .

Format 演算子 -f

Index 演算子 [ ]

パイプライン演算子 |

パイプラインチェーン演算子 && と ||

範囲演算子 ..

メンバーアクセス演算子 .

静的メンバー演算子 ::

三項演算子 ? <if-true> : <if-false>

Null 合体演算子 ??

Null 合体代入演算子 ??=

Null 条件演算子 ?. と ?[]

関連項目

フィードバック

グループ化演算子 `( )`

部分式演算子 `$( )`

配列の部分式演算子 `@( )`

ハッシュテーブルリテラルの構文 `@{}`

Call 演算子 `&`

Background 演算子 `&`

Cast 演算子 `[ ]`

コンマ演算子 `,`

ドットソーシング演算子 `.`

Format 演算子 `-f`

Index 演算子 `[ ]`

パイプライン演算子 `|`

パイプラインチェーン演算子 `&&` と `||`

範囲演算子 `..`

メンバーアクセス演算子 `.`

静的メンバー演算子 `::`

三項演算子 `? <if-true> : <if-false>`

Null 合体演算子 `??`

Null 合体代入演算子 `??=`

Null 条件演算子 `?.` と `?[]`