New-Guid
建立一個 GUID。
語法
Default (預設值)
New-Guid
[<CommonParameters>]
Empty
New-Guid
[-Empty]
[<CommonParameters>]
InputObject
New-Guid
[-InputObject <String>]
[<CommonParameters>]
Description
該 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。 或者，你也可以把這個 cmdlet 的輸出存到變數裡，方便在腳本的其他地方使用。
範例 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 字串的第三組中。 版本 7 的 UUID 以該位置7的 a 7f30 開頭（），而版本 4 的 UUID 顯示 4 （48fa）。
參數
-Empty
表示此 cmdlet 會產生空的 GUID。 空的 GUID 字串中所有零。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Empty
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InputObject
此參數接受代表 GUID 的字串，並將其轉換為 GUID 物件。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
InputObject
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸出
Guid
此指令子回傳一個 GUID。
備註
指令長檔將字串輸入傳給 System.Guid 類別的建構子。 建構子支援多種格式的字串。 欲了解更多資訊，請參閱 System.Guid（String）。
當不使用字串輸入或 Empty 參數時，cmdlet 會產生 RFC 9562 中定義的第 7 版通用唯一識別碼（UUID）。
在 PowerShell 7.6 及更早版本中，cmdlet 會產生一個版本 4（隨機）UUID。 如果你需要版本 4 的 UUID，請使用 [guid]::NewGuid()。 若要明確建立版本 7 UUID，請使用 [guid]::CreateVersion7()。
更多資訊請參閱 System.Guid.CreateVersion7。
