about_Type_Operators

簡単な説明

Microsoft .NET 型で動作する演算子について説明します。

詳細な説明

ブール型演算子 (-is および) は、 -isnotオブジェクトが指定された .NET 型のインスタンスであるかどうかを示します。 演算子は、型が一致する場合は -is TRUE の値を返し、それ以外の場合は FAL の値Standard Edition返します。 この演算子は-isnot、型が一致する場合は FAL Standard Edition の値を返し、それ以外の場合は TRUE の値を返します。

演算子は -as 、入力オブジェクトを指定した .NET 型に変換しようとします。 成功した場合は、変換されたオブジェクトを返します。 失敗した場合は、$null を返します。 エラーは返されません。

PowerShell には、次の型演算子があります。

• -is |入力が指定した .NET 型のインスタンスである場合は TRUE を返します。

  (get-date) -is [DateTime]     # Result is True
  

• -isnot|入力が specified.NET 型のインスタンスでない場合は TRUE を返します。

  (get-date) -isnot [DateTime]  # Result is False
  

• -as |入力を指定した .NET 型に変換します。

  "5/7/07" -as [DateTime]       # Result is Monday, May 7, 2007 12:00:00 AM
  

型演算子の構文は次のとおりです。

<input> <operator> [.NET type]

次の構文を使用することもできます。

<input> <operator> ".NET type"

.NET 型は、角かっこで囲まれた型名、または System.DateTime などの[DateTime]"DateTime"文字列として書き込むことができます。 型がシステム名前空間のルートにない場合は、オブジェクト型の完全な名前を指定します。 "System" は省略できます。 たとえば、System.Diagnostics.Process を指定するには、次のように入力[System.Diagnostics.Process]します"Diagnostics.Process"。 [Diagnostics.Process]

型演算子は、常に入力オブジェクト全体で動作します。 つまり、入力オブジェクトがコレクションの場合は、コレクションの要素の型ではなく、テストされるコレクション型です。

-is/isnot 演算子

ブール型演算子 (-isおよび-isnot) は、入力がオブジェクトのコレクションである場合でも、常にブール値を返します。

.NET 型と同じ型または .NET 型から派生した型の場合<input>、-is演算子$Trueは .

たとえば、DirectoryInfo 型は FileSystemInfo 型から派生します。 したがって、これらの両方の例は True を返します。

PS> (Get-Item /) -is [System.IO.DirectoryInfo]
True
PS> (Get-Item /) -is [System.IO.FileSystemInfo]
True

比較でインターフェイスが実装されている<input>場合、演算子は-isインターフェイスと一致することもできます。 この例では、入力は配列です。 配列は System.Collections.IList インターフェイスを実装します。

PS> 1, 2 -is [System.Collections.IList]
True

-as 演算子

演算子は -as 、入力オブジェクトを指定した .NET 型に変換しようとします。 成功した場合は、変換されたオブジェクトを返します。 失敗した場合は、返されます $null。 エラーは返されません。

<input>.NET 型-asから派生した型が渡された場合、入力オブジェクトは変更されずに返されます。 たとえば、DirectoryInfo 型は FileSystemInfo 型から派生します。 そのため、オブジェクトの種類は次の例では変更されません。

PS> $fsroot = (Get-Item /) -as [System.IO.FileSystemInfo]
PS> $fsroot.GetType().FullName
System.IO.DirectoryInfo

DateTime 型の変換はカルチャに依存します

型キャストとは異なり、演算子を使用した-as型への[DateTime]変換は、現在のカルチャの規則に従って書式設定された文字列でのみ機能します。

PS> [cultureinfo]::CurrentCulture = 'fr-FR'
PS> '13/5/20' -as [datetime]

mercredi 13 mai 2020 00:00:00

PS> '05/13/20' -as [datetime]
PS> [datetime]'05/13/20'

mercredi 13 mai 2020 00:00:00

PS> [datetime]'13/05/20'
InvalidArgument: Cannot convert value "13/05/20" to type "System.DateTime".
Error: "String '13/05/20' was not recognized as a valid DateTime."

オブジェクトの .NET 型を検索するには、コマンドレットを Get-Member 使用します。 または、すべてのオブジェクトの GetType メソッドを、このメソッドの FullName プロパティと共に使用します。 たとえば、次のステートメントは、コマンドの戻り値の型を Get-Culture 取得します。

PS> (Get-Culture).GetType().FullName
System.Globalization.CultureInfo

例

次の例は、Type 演算子の一部の使用方法を示しています。

PS> 32 -is [Float]
False

PS> 32 -is "int"
True

PS> (get-date) -is [DateTime]
True

PS> "12/31/2007" -is [DateTime]
False

PS> "12/31/2007" -is [String]
True

PS> (get-process PowerShell)[0] -is [System.Diagnostics.Process]
True

PS> (get-command get-member) -is [System.Management.Automation.CmdletInfo]
True

次の例は、入力がオブジェクトのコレクションである場合、一致する型はコレクション内の個々のオブジェクトの型ではなく、コレクションの .NET 型であることを示しています。

この例では、コマンドレットとコマンドレットのGet-Culture両方が System.Globalization.CultureInfo オブジェクトを返しますが、これらのオブジェクトのコレクションは System.Object 配列Get-UICultureです。

PS> (get-culture) -is [System.Globalization.CultureInfo]
True

PS> (get-uiculture) -is [System.Globalization.CultureInfo]
True

PS> (get-culture), (get-uiculture) -is [System.Globalization.CultureInfo]
False

PS> (get-culture), (get-uiculture) -is [Array]
True

PS> (get-culture), (get-uiculture) | foreach {
  $_ -is [System.Globalization.CultureInfo])
}
True
True

PS> (get-culture), (get-uiculture) -is [Object]
True

次の例は、演算子の使用方法を -as 示しています。

PS> "12/31/07" -is [DateTime]
False

PS> "12/31/07" -as [DateTime]
Monday, December 31, 2007 12:00:00 AM

PS> $date = "12/31/07" -as [DateTime]

C:\PS>$a -is [DateTime]
True

PS> 1031 -as [System.Globalization.CultureInfo]

LCID      Name      DisplayName
----      ----      -----------
1031      de-DE     German (Germany)

次の例は、演算子が入力オブジェクトを -as .NET 型に変換できない場合に返されることを示しています $null。

PS> 1031 -as [System.Diagnostics.Process]
PS>

関連項目

• about_Operators