New-Guid
GUID を作成します。
構文
Default (既定)
New-Guid
[<CommonParameters>]
Empty
New-Guid
[-Empty]
[<CommonParameters>]
InputObject
New-Guid
[-InputObject <String>]
[<CommonParameters>]
説明
New-Guid コマンドレットは、バージョン 7 のグローバル一意識別子 (GUID) を作成します。 バージョン 7 の UUID にはミリ秒単位のタイムスタンプが含まれており、並べ替え可能です。 スクリプトで一意の ID が必要な場合は、必要に応じて GUID を作成できます。
Note
PowerShell 7.6 以前では、 New-Guid バージョン 4 (ランダム) UUID が作成されました。 PowerShell 7.7 以降では、既定値がバージョン 7 に変更されました。 バージョン 4 UUID が必要な場合は、 [guid]::NewGuid() を直接使用します。
例
例 1: 新しい GUID を作成する
New-Guid
このコマンドは GUID を作成します。 または、このコマンドレットの出力を変数に格納して、スクリプト内の他の場所で使用することもできます。
例 2: 空の GUID を作成する
New-Guid -Empty
Guid
----
00000000-0000-0000-0000-000000000000
例 3: 文字列から GUID を作成する
次の使用例は、GUID を含む文字列を GUID オブジェクトに変換します。
New-Guid -InputObject "d61bbeca-0186-48fa-90e1-ff7aa5d33e2d"
Guid
----
d61bbeca-0186-48fa-90e1-ff7aa5d33e2d
例 4: パイプラインから GUID に文字列を変換する
この例では、パイプラインから GUID オブジェクトに文字列を変換します。
$guidStrings = (
'11c43ee8-b9d3-4e51-b73f-bd9dda66e29c',
'0f8fad5bd9cb469fa16570867728950e',
'{0x01234567, 0x89ab, 0xcdef,{0x01,0x23,0x45,0x67,0x89,0xab,0xcd,0xef}}'
)
$guidStrings | New-Guid
Guid
----
11c43ee8-b9d3-4e51-b73f-bd9dda66e29c
0f8fad5b-d9cb-469f-a165-70867728950e
01234567-89ab-cdef-0123-456789abcdef
例 5: .NET API を使用して特定の UUID バージョンを作成する
この例では、.NET API を直接使用して特定の UUID バージョンを作成する方法を示します。
[guid]::CreateVersion7()
[guid]::NewGuid()
Guid
----
019588a4-dbe2-7f30-8b9f-4a1c0e5d3a28
d61bbeca-0186-48fa-90e1-ff7aa5d33e2d
バージョン番号は、GUID 文字列の 3 番目のグループに表示されます。 バージョン 7 の UUID は、その位置 (7) の7f30で始まり、バージョン 4 の UUID には4 (48fa) が表示されます。
パラメーター
-Empty
このコマンドレットが空の GUID を作成することを示します。 空の GUID の文字列には、すべてのゼロが含まれています。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Empty
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-InputObject
このパラメーターは、GUID を表す文字列を受け取り、GUID オブジェクトに変換します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
InputObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。
出力
Guid
このコマンドレットは GUID を返します。
メモ
このコマンドレットは、文字列入力を System.Guid クラスのコンストラクターに渡します。 コンストラクターは、複数の形式の文字列をサポートします。 詳細については、「 System.Guid(String)」を参照してください。
文字列入力または Empty パラメーターなしで使用する場合、コマンドレットは RFC 9562 で定義されているバージョン 7 ユニバーサル一意識別子 (UUID) を作成します。
PowerShell 7.6 以前では、コマンドレットによってバージョン 4 (ランダム) UUID が作成されました。 バージョン 4 UUID が必要な場合は、 [guid]::NewGuid()を使用します。 バージョン 7 UUID を明示的に作成するには、 [guid]::CreateVersion7()を使用します。
詳細については、「 System.Guid.CreateVersion7」を参照してください。