about_Enum
簡単な説明
ステートメントは enum
列挙型を宣言します。 列挙型は、列挙子リストと呼ばれる名前付きラベルのセットで構成される個別の型です。
詳細な説明
この enum
ステートメントを使用すると、厳密に型指定されたラベルのセットを作成できます。 スペル ミスを解析したりチェックしたりする必要なく、コードでその列挙体を使用できます。
列挙型は、開始値が 0 の整数値型として内部的に表されます。 既定では、PowerShell 列挙型は基になる型として System.Int32 ([int]
) を使用します。 既定では、PowerShell はリスト内の最初のラベルに値 0 を割り当てます。 既定では、PowerShell は、連続する整数を持つ再メインラベルを割り当てます。
定義では、ラベルに任意の整数値を指定できます。 値が割り当てられていないラベルは、次の整数値を受け取ります。
構文
列挙型では、次の構文が使用されます。
整数列挙定義の構文
[[<attribute>]...] enum <enum-name> {
<label> [= <int-value>]
...
}
特定の基になる型列挙型の定義構文
[[<attribute>]...] enum <enum-name> : <underlying-type-name> {
<label> [= <int-value>]
...
}
フラグ列挙定義の構文
[[<attribute>]...] [Flag()] enum <enum-name>[ : <underlying-type-name>] {
<label 0> [= 1]
<label 1> [= 2]
<label 2> [= 4]
<label 3> [= 8]
...
...
}
列挙アクセス構文
[<enum-name>]::<label>
例
例 1 - 最小列挙
次のコード ブロックは、3 つのラベルを 持つ MarkdownUnorderedListCharacter 列挙体を定義します。 どのラベルにも明示的な値は割り当てられません。
enum MarkdownUnorderedListCharacter {
Asterisk
Dash
Plus
}
次のコード ブロックは、列挙型にキャストするときに整数と文字列の両方の値がどのように動作するかを示しています。
$ValuesToConvert = @(0, 'Asterisk', 1, 'Dash', 2, 'Plus')
foreach ($Value in $ValuesToConvert) {
[MarkdownUnorderedListCharacter]$EnumValue = $Value
[pscustomobject]@{
AssignedValue = $Value
Enumeration = $EnumValue
AreEqual = $Value -eq $EnumValue
}
}
AssignedValue Enumeration AreEqual
------------- ----------- --------
0 Asterisk True
Asterisk Asterisk True
1 Dash True
Dash Dash True
2 Plus True
Plus Plus True
列挙型の値と等しい整数をキャストすると、その列挙型が返されます。 列挙体のラベルと同じ文字列をキャストすると、その列挙型が返されます。
例 2 - 明示的な列挙値とシノニム列挙値
次の例は、メディア ファイルに関連付けられるオブジェクトの列挙体を示しています。 この定義では、基になる値picture
video
に明示的な値music
が割り当てられます。 明示的な割り当ての直後のラベルは、次の整数値を取得します。 同じ値を別のラベルに割り当てることで、シノニムを作成できます。で構築された値を参照してください。 ogg
oga
mogg
jpg
jpeg
mpg
mpeg
enum MediaTypes {
unknown
music = 10
mp3
aac
ogg = 15
oga = 15
mogg = 15
picture = 20
jpg
jpeg = 21
png
video = 40
mpg
mpeg = 41
avi
m4v
}
このメソッドは GetEnumNames()
、列挙体のラベルの一覧を返します。
[MediaTypes].GetEnumNames()
unknown
music
mp3
aac
ogg
oga
mogg
picture
jpg
jpeg
png
video
mpg
mpeg
avi
m4v
このメソッドは GetEnumValues()
、列挙の値の一覧を返します。
[MediaTypes].GetEnumValues()
unknown
music
mp3
aac
ogg
ogg
ogg
picture
jpg
jpg
png
video
mpg
mpg
avi
m4v
Note
GetEnumNames()
同 GetEnumValues()
じ結果を返すように見えます。名前付き値のリストです。 ただし、内部的には値 GetEnumValues()
を列挙し、値を名前にマップします。 リストを注意深く読んで、mogg
oga
出力にGetEnumNames()
表示されることに気付ogg
くでしょうが、出力GetEnumValues()
は表示ogg
されるだけです。 同じことが 、について行われますjpg
mpg
jpeg
mpeg
。 シノニム値に対して PowerShell から返される名前は決定論的ではありません。
このメソッドを GetEnumName()
使用して、特定の値に関連付けられている名前を取得できます。 1 つの値に複数の名前が関連付けられている場合、メソッドは最初に定義された名前を返します。
[MediaTypes].GetEnumName(15)
ogg
次の例は、各名前をその値にマップする方法を示しています。
[MediaTypes].GetEnumNames() | ForEach-Object {
[pscustomobject]@{
Name = $_
Value = [int]([MediaTypes]::$_)
}
}
Name Value
---- -----
unknown 0
music 10
mp3 11
aac 12
ogg 15
oga 15
mogg 15
picture 20
jpg 21
jpeg 21
png 22
video 40
mpg 41
mpeg 41
avi 42
m4v 43
構文 [<enum-name>]::<label>
を使用して、ラベルによって単一の列挙値を指定できます。
[MediaTypes]::png
[MediaTypes]::png -eq 22
png
True
例 3 - フラグとしての列挙
次のコード ブロックでは、 FileAttributes 列挙をビット フラグのセットとして作成します。 各ラベルの値は、前のラベルの値の 2 倍です。
[Flags()] enum FileAttributes {
Archive = 1
Compressed = 2
Device = 4
Directory = 8
Encrypted = 16
Hidden = 32
}
[FileAttributes]$file1 = [FileAttributes]::Archive
[FileAttributes]$file1 += [FileAttributes]::Compressed
[FileAttributes]$file1 += [FileAttributes]::Device
"file1 attributes are: $file1"
[FileAttributes]$file2 = [FileAttributes]28 ## => 16 + 8 + 4
"file2 attributes are: $file2"
file1 attributes are: Archive, Compressed, Device
file2 attributes are: Device, Directory, Encrypted
特定のフラグが設定されているかどうかをテストするには、二項比較演算子 -band
を使用します。 この例では、Device 属性と Archive 属性の値$file2
をテストします。
PS > ($file2 -band [FileAttributes]::Device) -eq [FileAttributes]::Device
True
PS > ($file2 -band [FileAttributes]::Archive) -eq [FileAttributes]::Archive
False
このメソッドを HasFlag()
使用して、特定のフラグが設定されているかどうかをテストすることもできます。
次の例では、値の Device 属性と Hidden 属性を $file1
テストします。
PS > $file1.HasFlag([FileAttributes]::Device)
True
PS > $file1.HasFlag([FileAttributes]::Hidden)
False
例 4 - パラメーターとしての列挙
次の例では、この関数ConvertTo-LineEndingRegex
は EndOfLine 型の InputObject パラメーターを定義します。
enum EndOfLine {
CR = 1
LF = 2
CRLF = 3
}
function ConvertTo-LineEndingRegex {
[CmdletBinding()]
param (
[Parameter(ValueFromPipeline)]
[EndOfLine[]]$InputObject
)
process {
switch ($InputObject) {
CR { '\r' }
LF { '\n' }
CRLF { '\r\n' }
}
}
}
[EndOfLine]::CR | ConvertTo-LineEndingRegex
'CRLF' | ConvertTo-LineEndingRegex
ConvertTo-LineEndingRegex 2
\r
\r\n
\n
この例では、最初のステートメント呼び出しで ConvertTo-LineEndingRegex
〗の列挙値 CR
が渡されます。 2 番目のステートメントは、LineEnding にキャストされる文字列'CRLF'
を渡します。 3 番目のステートメントは、ラベルにマップされるパラメーターの値 2
を LF
指定します。
PowerShell プロンプトに次のテキストを入力すると、引数の入力候補オプションを確認できます。
ConvertTo-LineEndingRegex -InputObject <Tab>
パラメーターに無効なラベル名または数値を指定すると、エラーが発生します。
ConvertTo-LineEndingRegex -InputObject 0
ConvertTo-LineEndingRegex: Cannot process argument transformation on
parameter 'InputObject'. Cannot convert value "0" to type "EndOfLine" due
to enumeration values that are not valid. Specify one of the following
enumeration values and try again. The possible enumeration values are
"CR,LF,CRLF".
例 5 - 特定の基になる型を持つ列挙型
PowerShell 6.2 以降では、特定の基になる型を持つ列挙型を定義できます。 この例では、列挙型の有効な基になる型を示します。
最初のコード ブロックは、2 つの変数を配列として初期化します。 $EnumTypes
は、動的に作成された型を保持する空の配列です。 $IntegralTypes
は、列挙型の有効な基になる型を含む配列です。
$EnumTypes = @()
$IntegralTypes = @(
'byte', 'sbyte', 'short', 'ushort', 'int', 'uint', 'long', 'ulong'
)
次のコード ブロックでは、列挙定義を動的に作成するために使用するテンプレートを定義します。 書式プレースホルダーが {0}
整数型名に置き換えられると、テンプレートによって次のスクリプト ブロックが作成されます。
のような
byteEnum
名前<type>Enum
の列挙体を定義します。 定義された列挙型は、基になる値型として指定された整数型を使用します。列挙型は、整数型の
Min
最小値に設定された値で定義されます。 整数型のMax
最大値に設定された値を定義します。新しく定義された型を返します。
$DefinitionTemplate = @"
enum {0}Enum : {0} {{
Min = [{0}]::MinValue
Max = [{0}]::MaxValue
}}
[{0}Enum]
"@
次のコード ブロックでは、テンプレートを使用して、現在のスコープでスクリプト ブロックを作成して呼び出します。 返された型定義が配列に $EnumTypes
追加されます。
foreach ($IntegralType in $IntegralTypes) {
$Definition = $DefinitionTemplate -f $IntegralType
$ScriptBlock = [scriptblock]::Create($Definition)
$EnumTypes += . $ScriptBlock
}
最後のコード ブロックは、列挙型をループ処理し、メソッドを GetEnumValuesAsUnderlyingType()
使用して値を基になる型として一覧表示します。 ループでは、値ごとに新しいオブジェクトが作成され、列挙型、値の型、ラベル、および実際の値が表示されます。
foreach ($EnumType in $EnumTypes) {
$EnumType.GetEnumValuesAsUnderlyingType() | ForEach-Object {
[pscustomobject]@{
EnumType = $EnumType.FullName
ValueType = $_.GetType().FullName
Label = $EnumType.GetEnumName($_)
Value = $_
}
}
}
EnumType ValueType Label Value
-------- --------- ----- -----
byteEnum System.Byte Min 0
byteEnum System.Byte Max 255
sbyteEnum System.SByte Max 127
sbyteEnum System.SByte Min -128
shortEnum System.Int16 Max 32767
shortEnum System.Int16 Min -32768
ushortEnum System.UInt16 Min 0
ushortEnum System.UInt16 Max 65535
intEnum System.Int32 Max 2147483647
intEnum System.Int32 Min -2147483648
uintEnum System.UInt32 Min 0
uintEnum System.UInt32 Max 4294967295
longEnum System.Int64 Max 9223372036854775807
longEnum System.Int64 Min -9223372036854775808
ulongEnum System.UInt64 Min 0
ulongEnum System.UInt64 Max 18446744073709551615
列挙メソッド
次の一覧には、PowerShell の列挙体で使用できる便利なメソッドとその使用方法が含まれています。
形式
静的メソッドは Format()
、特定の列挙型、列挙値、および書式指定文字列の書式設定された文字列出力を返します。 出力は、指定した書式指定文字列を使用して値に 対して ToString メソッドを呼び出すのと同じです。
System.Enum 基底クラス型または特定の列挙型で静的メソッドを使用できます。
[System.Enum]::format([<enum-name>], <value>, <format-string>)
[<enum-name>]::format([<enum-name>], <value>, <format-string>)
有効な書式指定文字列は、または 、または、または 、または x
.F
f
X
d
D
g
G
詳細については、「列挙型書式指定文字列」を参照してください。
次の例では、サポートされている各列挙型書式指定文字列を使用して、TaskState 列挙の各値を文字列形式に変換します。
enum TaskState {
ToDo
Doing
Done
}
# String format template for the statements
$Statement = "[System.Enum]::Format([TaskState], {0}, '{1}')"
foreach ($Format in @('G', 'D', 'X', 'F')) {
$StatementToDo = $Statement -f 0, $Format
$StatementDoing = $Statement -f "([TaskState]'Doing')", $Format
$StatementDone = $Statement -f '[TaskState]::Done', $Format
$FormattedToDo = [System.Enum]::Format(
[TaskState], 0, $Format
)
$FormattedDoing = [System.Enum]::Format(
[TaskState], ([TaskState]'Doing'), $Format
)
$FormattedDone = [System.Enum]::Format(
[TaskState], [TaskState]::Done, $Format
)
"{0,-62} => {1}" -f $StatementToDo, $FormattedToDo
"{0,-62} => {1}" -f $StatementDoing, $FormattedDoing
"{0,-62} => {1}" -f $StatementDone, $FormattedDone
}
[System.Enum]::Format([TaskState], 0, 'G') => ToDo
[System.Enum]::Format([TaskState], ([TaskState]'Doing'), 'G') => Doing
[System.Enum]::Format([TaskState], [TaskState]::Done, 'G') => Done
[System.Enum]::Format([TaskState], 0, 'D') => 0
[System.Enum]::Format([TaskState], ([TaskState]'Doing'), 'D') => 1
[System.Enum]::Format([TaskState], [TaskState]::Done, 'D') => 2
[System.Enum]::Format([TaskState], 0, 'X') => 00000000
[System.Enum]::Format([TaskState], ([TaskState]'Doing'), 'X') => 00000001
[System.Enum]::Format([TaskState], [TaskState]::Done, 'X') => 00000002
[System.Enum]::Format([TaskState], 0, 'F') => ToDo
[System.Enum]::Format([TaskState], ([TaskState]'Doing'), 'F') => Doing
[System.Enum]::Format([TaskState], [TaskState]::Done, 'F') => Done
GetEnumName
リフレクション メソッドは GetEnumName()
、特定の列挙値の名前を返します。 入力値は、整数や列挙値などの列挙型の有効な基になる型である必要があります。 1 つの値に複数の名前が関連付けられている場合、メソッドは最初に定義された名前を返します。
[<enum-name>].GetEnumName(<value>)
enum GateState {
Unknown
Open
Opening
Closing
Closed
}
foreach ($Value in 0..4) {
[pscustomobject]@{
IntegerValue = $Value
EnumName = [GateState].GetEnumName($Value)
}
}
IntegerValue EnumName
------------ --------
0 Unknown
1 Open
2 Opening
3 Closing
4 Closed
GetEnumNames
リフレクション メソッドは GetEnumNames()
、すべての列挙値の名前を文字列として返します。 出力にはシノニムが含まれます。
[<enum-name>].GetEnumNames()
enum Season {
Unknown
Spring
Summer
Autumn
Winter
Fall = 3
}
[Season].GetEnumNames()
Unknown
Spring
Summer
Fall
Autumn
Winter
GetEnumUnderlyingType
リフレクション メソッドは GetEnumUnderlyingType()
、列挙値の基になる型を返します。
[<enum-name>].GetEnumUnderlyingType()
enum IntBasedEnum {
Zero
One
Two
}
enum ShortBasedEnum : short {
Zero
One
Two
}
foreach ($EnumType in @([IntBasedEnum], [ShortBasedEnum])) {
[pscustomobject]@{
EnumType = $EnumType
ValueType = $EnumType.GetEnumUnderlyingType()
}
}
EnumType ValueType
-------- ---------
IntBasedEnum System.Int32
ShortBasedEnum System.Int16
GetEnumValues
リフレクション メソッドは GetEnumValues()
、列挙型に対して定義されたすべての値を返します。
[<enum-name>].GetEnumValues()
enum Season {
Unknown
Spring
Summer
Autumn
Winter
Fall = 3
}
[Season].GetEnumValues()
Unknown
Spring
Summer
Fall
Fall
Winter
GetEnumValuesAsUnderlyingType
リフレクション メソッドは GetEnumValuesAsUnderlyingType()
、列挙型に対して定義されたすべての値を基になる型として返します。
[<enum-name>].GetEnumValuesAsUnderlyingType()
enum IntBasedEnum {
Zero
One
Two
}
enum ShortBasedEnum : short {
Zero
One
Two
}
foreach ($EnumType in @([IntBasedEnum], [ShortBasedEnum])) {
[pscustomobject]@{
EnumType = $EnumType
ValueType = $EnumType.GetEnumValuesAsUnderlyingType()[0].GetType()
}
}
EnumType ValueType
-------- ---------
IntBasedEnum System.Int32
ShortBasedEnum System.Int16
HasFlag
インスタンス メソッドは HasFlag
、フラグ列挙値にビット フラグが設定されているかどうかを判断します。 このメソッドを使用すると、バイナリ比較と等価チェックを行うよりも短く読みやすくなっています。
<enum-value>.HasFlag(<enum-flag-value>)
次の例では、 ModuleFeatures フラグ列挙体を 定義し、値 39
に含まれるフラグを示します。
[Flags()] enum ModuleFeatures {
Commands = 1
Classes = 2
Enums = 4
Types = 8
Formats = 16
Variables = 32
}
$Features = [ModuleFeatures]39
foreach ($Feature in [ModuleFeatures].GetEnumValues()) {
"Has flag {0,-12}: {1}" -f "'$Feature'", ($Features.HasFlag($Feature))
}
Has flag 'Commands' : True
Has flag 'Classes' : True
Has flag 'Enums' : True
Has flag 'Types' : False
Has flag 'Formats' : False
Has flag 'Variables' : True
Isdefined
静的メソッドは IsDefined()
、 $true
入力値が列挙型に対して定義されている場合は返され、それ以外の場合 $false
は返されます。 このメソッドを使用して、無効な引数エラーを処理することなく、列挙に対して値が有効かどうかをチェックします。
System.Enum 基底クラス型または特定の列挙型で静的メソッドを使用できます。
[System.Enum]::IsDefined([<enum-name>], <value>)
[<enum-name>]::IsDefined([<enum-name>], <value>)
enum Season {
Unknown
Spring
Summer
Autumn
Winter
Fall = 3
}
foreach ($Value in 0..5) {
$IsValid = [Season]::IsDefined([Season], $Value)
$EnumValue = if ($IsValid) { [Season]$Value }
[pscustomobject] @{
InputValue = $Value
IsValid = $IsValid
EnumValue = $EnumValue
}
}
InputValue IsValid EnumValue
---------- ------- ---------
0 True Unknown
1 True Spring
2 True Summer
3 True Fall
4 True Winter
5 False
ToString
インスタンス メソッドは ToString()
、列挙値のラベルを返します。
このメソッドは、列挙値が出力として表示される方法の既定のビューでもあります。 必要に応じて、値の表示方法を制御する書式指定文字列を指定できます。 書式設定の詳細については、「列挙値の書式設定」を参照してください。
Note
特定の値のシノニムを定義する列挙型の場合は、出力 ToString()
に依存するコードを記述しないでください。 このメソッドは、値の任意の有効な名前を返すことができます。
<enum-value>.ToString([<format-string>])
次の例では、Shade 列挙型をシノニムとして定義しますGrey
。Gray
次に、実際の列挙値、文字列としての列挙型、および列挙型を整数として示すオブジェクトを出力します。
enum Shade {
White
Grey
Gray = 1
Black
}
[Shade].GetEnumValues() | Foreach-Object -Process {
[pscustomobject]@{
EnumValue = $_
StringValue = $_.ToString()
IntegerValue = [int]$_
}
}
numValue StringValue IntegerValue
--------- ----------- ------------
White White 0
Grey Grey 1
Grey Grey 1
Black Black 2
列挙値のシノニム
同じ整数値に異なる名前を付ける列挙型を定義できます。 これを行うと、同じ基になる値を指す名前がシノニムと呼ばれます。 シノニムを持つ列挙型を使用すると、ユーザーは同じ値に異なる名前を指定できます。
シノニムを持つ列挙型を定義するときは、特定の名前に変換するシノニム値に依存するコードを記述しないでください。 シノニム文字列を列挙値に変換するコードを確実に記述できます。 列挙値自体を操作するときは、常に文字列としてではなく、列挙値またはその基になる型として比較します。
次のコード ブロックでは、シノニムの付いた Grey
Shade 列挙型を定義しますGray
。
enum Shade {
White
Grey
Gray = 1
Black
}
[Shade]'Grey' -eq [Shade]::Gray
[Shade]::Grey -eq 1
[Shade]'Gray' -eq 1
True
True
True
フラグとしての列挙型
列挙型の一般的な用途の 1 つは、相互に排他的な値のセットを表すことです。 たとえば、ArrivalStatus インスタンスには、Early、OnTime、Late のいずれかの値を指定できます。 ArrivalStatus インスタンスの値が複数の列挙定数を反映しても意味がありません。
ただし別の場合、列挙オブジェクトの値には複数の列挙体メンバーを含めることができ、各メンバーは列挙値のビットフィールドを表します。 FlagsAttribute を使用して、列挙体が、ユーザーが結合できるフラグとしてビット フィールドで構成されていることを示すことができます。
フラグとしての列挙型が正しく機能するためには、各ラベルの整数値を 2 の累乗に設定する必要があります。 ラベルの値を指定しない場合、PowerShell は値を前のラベルより 1 つ高いものに設定します。
一般的に使用されるフラグの組み合わせの値を定義して、ユーザーが一度にフラグのセットを簡単に指定できるようにすることができます。 値の名前は、フラグの結合名にする必要があります。 整数値は、フラグ値の合計である必要があります。
特定のフラグが値に設定されているかどうかを判断するには、値に対してメソッドを HasFlag()
使用するか、二項比較演算子を使用します -band
。
フラグ列挙体の使用方法と、フラグが設定されているかどうかをチェックする方法を示すサンプルについては、例 3 を参照してください。
パラメーターとしての列挙型
列挙型を型として使用するコマンドレット パラメーターを定義できます。 パラメーターの型として列挙型を指定すると、ユーザーはパラメーターの値の自動補完と検証を受け取ります。 引数の入力候補は、列挙型の有効なラベルの一覧を示します。
パラメーターの型として列挙型がある場合は、次のいずれかを指定できます。
- 次のような列挙体
[<EnumType>]::<Label>
- 文字列としての列挙体のラベル
- 列挙体の数値
列挙型パラメーターの動作を示すサンプルについては、例 4 を参照してください。
特定の基になる型を持つ列挙型
PowerShell 6.2 以降では、特定の基になる型を持つ列挙型を定義できます。 特定の基になる型を持たない列挙型を定義すると、PowerShell は基になる型として (System.Int32) を持つ[int]
列挙型を作成します。
列挙型の基になる型は整数の数値型である必要があります。 次の一覧には、短い名前と完全な型名を持つ有効な型が含まれています。
byte
- System.Bytesbyte
- System.SByteshort
- System.Int16ushort
- System.UInt16int
- System.Int32uint
- System.UInt32long
- System.Int64ulong
- System.UInt64
列挙型の基になる特定の型は、短い名前または完全な型名として定義できます。 次の定義は機能的に同じです。 基になる型に使用される名前のみが異なります。
enum LongValueEnum : long {
Zero
One
Two
}
enum LongValueEnum : System.Int64 {
Zero
One
Two
}
列挙値の書式設定
列挙値を文字列形式に変換するには、静的な Format メソッドと、インスタンス の ToString メソッドのオーバーロードを呼び出します。 書式指定文字列を使用して、列挙値を文字列として表す正確な方法を制御できます。 詳細については、「列挙型書式指定文字列」を参照してください。
次の例では、サポートされている各列挙書式指定文字列 (G
または、またはg
、D
またはd
、または、X
またはx
) F
f
を使用して、TaskState 列挙体の各メンバーをその文字列表現に変換します。
enum TaskState {
ToDo
Doing
Done
}
[TaskState].GetEnumValues() | ForEach-Object {
[pscustomobject]@{
"ToString('G')" = $_.ToString('G')
"ToString('D')" = $_.ToString('D')
"ToString('X')" = $_.ToString('X')
"ToString('F')" = $_.ToString('F')
}
}
ToString('G') ToString('D') ToString('X') ToString('F')
------------- ------------- ------------- -------------
ToDo 0 00000000 ToDo
Doing 1 00000001 Doing
Done 2 00000002 Done
次の例では、フラグ列挙の値に書式指定文字列を使用します。
[Flags()] enum FlagEnum {
A = 1
B = 2
C = 4
}
$FlagValues = @(
[FlagEnum]::A # 1
[FlagEnum]::B # 2
[FlagEnum]::A + [FlagEnum]::B # 3
[FlagEnum]::C # 4
[FlagEnum]::C + [FlagEnum]::A # 5
[FlagEnum]::C + [FlagEnum]::B # 6
[FlagEnum]::C + [FlagEnum]::A + [FlagEnum]::B # 7
[FlagEnum]::C + [FlagEnum]::C # 8
)
foreach ($Value in $FlagValues) {
[pscustomobject]@{
"ToString('G')" = $Value.ToString('G')
"ToString('D')" = $Value.ToString('D')
"ToString('X')" = $Value.ToString('X')
"ToString('F')" = $Value.ToString('F')
}
}
ToString('G') ToString('D') ToString('X') ToString('F')
------------- ------------- ------------- -------------
A 1 00000001 A
B 2 00000002 B
A, B 3 00000003 A, B
C 4 00000004 C
A, C 5 00000005 A, C
B, C 6 00000006 B, C
A, B, C 7 00000007 A, B, C
8 8 00000008 8
フラグ列挙の場合、およびF
書式指定文字列には、G
コンマで区切られた値のセット フラグの一覧が表示されます。 最後の値は、 8
実際には有効なフラグ セットではないため、フラグを一覧表示しません。 列挙フラグを組み合わせて、少なくとも 1 つのフラグを複製せずに合計 8
を取得することはできません。
Update-TypeData を使用した拡張メソッドの定義
列挙型の宣言でメソッドを定義することはできません。 列挙体の機能を拡張するには、Update-TypeData コマンドレットを使用して列挙型のメンバーを定義ScriptMethod
します。
次の例では、コマンドレットをUpdate-TypeData
使用して、FileAttributes フラグ列挙型にメソッドを追加GetFlags()
します。 値に設定されたフラグの配列を返します。
[Flags()] enum FileAttributes {
Archive = 1
Compressed = 2
Device = 4
Directory = 8
Encrypted = 16
Hidden = 32
}
$MemberDefinition = @{
TypeName = 'FileAttributes'
MemberName = 'GetFlags'
MemberType = 'ScriptMethod'
Value = {
foreach ($Flag in $this.GetType().GetEnumValues()) {
if ($this.HasFlag($Flag)) { $Flag }
}
}
}
Update-TypeData @MemberDefinition
$File = [FileAttributes]28
$File.GetFlags()
Device
Directory
Encrypted
型アクセラレータを使用した列挙型のエクスポート
既定では、PowerShell モジュールは、PowerShell で定義されているクラスと列挙型を自動的にエクスポートしません。 カスタム型は、ステートメントを呼び出さずにモジュールの外部では using module
使用できません。
ただし、モジュールが型アクセラレータを追加した場合、ユーザーがモジュールをインポートした後、それらの型アクセラレータはすぐにセッションで使用できます。
Note
型アクセラレータをセッションに追加するには、内部 (パブリックではない) API を使用します。 この API を使用すると、競合が発生する可能性があります。 モジュールのインポート時に同じ名前の型アクセラレータが既に存在する場合、次に示すパターンではエラーがスローされます。 また、セッションからモジュールを削除すると、型アクセラレータも削除されます。
このパターンにより、セッションで型を使用できるようになります。 VS Code でスクリプト ファイルを作成する場合、IntelliSense や入力候補には影響しません。
VS Code でカスタム型の IntelliSense と入力候補を取得するには、スクリプトの先頭にステートメントを追加 using module
する必要があります。
次のパターンは、PowerShell クラスと列挙型をモジュールの型アクセラレータとして登録する方法を示しています。 任意の型定義の後に、ルート スクリプト モジュールにスニペットを追加します。 モジュールを $ExportableTypes
インポートするときにユーザーが使用できるようにする各型が変数に含まれていることを確認します。 他のコードでは、編集は必要ありません。
# Define the types to export with type accelerators.
$ExportableTypes =@(
[DefinedTypeName]
)
# Get the internal TypeAccelerators class to use its static methods.
$TypeAcceleratorsClass = [psobject].Assembly.GetType(
'System.Management.Automation.TypeAccelerators'
)
# Ensure none of the types would clobber an existing type accelerator.
# If a type accelerator with the same name exists, throw an exception.
$ExistingTypeAccelerators = $TypeAcceleratorsClass::Get
foreach ($Type in $ExportableTypes) {
if ($Type.FullName -in $ExistingTypeAccelerators.Keys) {
$Message = @(
"Unable to register type accelerator '$($Type.FullName)'"
'Accelerator already exists.'
) -join ' - '
throw [System.Management.Automation.ErrorRecord]::new(
[System.InvalidOperationException]::new($Message),
'TypeAcceleratorAlreadyExists',
[System.Management.Automation.ErrorCategory]::InvalidOperation,
$Type.FullName
)
}
}
# Add type accelerators for every exportable type.
foreach ($Type in $ExportableTypes) {
$TypeAcceleratorsClass::Add($Type.FullName, $Type)
}
# Remove type accelerators when the module is removed.
$MyInvocation.MyCommand.ScriptBlock.Module.OnRemove = {
foreach($Type in $ExportableTypes) {
$TypeAcceleratorsClass::Remove($Type.FullName)
}
}.GetNewClosure()
ユーザーがモジュールをインポートすると、セッションの型アクセラレータに追加された型は、IntelliSense と完了にすぐに使用できます。 モジュールが削除されると、型アクセラレータも削除されます。
PowerShell モジュールから列挙型を手動でインポートする
Import-Module
ステートメントは、 #requires
モジュールによって定義されているモジュール関数、エイリアス、変数のみをインポートします。 列挙型はインポートされません。
モジュールでクラスと列挙型を定義するが、それらの型に型アクセラレータを追加しない場合は、ステートメントを using module
使用してそれらをインポートします。
このステートメントは using module
、スクリプト モジュールまたはバイナリ モジュールのルート モジュール (ModuleToProcess
) からクラスと列挙型をインポートします。 入れ子になったモジュールで定義されているクラスや、ルート モジュールにドット ソース化されたスクリプトで定義されているクラスは、一貫してインポートされません。 ルート モジュール内のモジュール外のユーザーが直接使用できるようにするクラスを定義します。
ステートメントのusing
詳細については、about_Usingを参照してください。
開発中に新しく変更されたコードを読み込む
スクリプト モジュールの開発中は、コードに変更を加え、Force パラメーターを使用してImport-Module
新しいバージョンのモジュールを読み込むのが一般的です。 これは、ルート モジュール内の関数に対する変更に対してのみ機能します。 Import-Module
では、入れ子になったモジュールは再読み込みされません。 また、更新されたクラスを読み込む方法はありません。
最新バージョンを確実に実行するには、新しいセッションを開始する必要があります。
PowerShell で定義され、ステートメントで using
インポートされたクラスと列挙型はアンロードできません。
もう 1 つの一般的な開発方法は、コードを異なるファイルに分割することです。 あるファイルに別のモジュールで定義された列挙型を使用する関数がある場合は、ステートメントを using module
使用して、関数に必要な列挙定義があることを確認する必要があります。
制限事項
PowerShell