New-Guid
建立 GUID。
語法
New-Guid []
New-Guid
[-Empty]
[<CommonParameters>]
New-Guid
[-InputObject <String>]
[<CommonParameters>]
Description
New-Guid
Cmdlet 會建立隨機全域唯一標識符 (GUID)。 如果您需要腳本中的唯一標識符,您可以視需要建立 GUID。
範例
範例 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
參數
-Empty
表示此 Cmdlet 會建立空的 GUID。 空的 GUID 在其字串中具有所有零。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InputObject
此參數接受代表 GUID 的字串,並將它轉換成 GUID 物件。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
輸出
此 Cmdlet 會傳回 GUID。
備註
Cmdlet 會將字串輸入傳遞給 System.Guid 類別的建構函式。 建構函式支持數種格式的字串。 如需詳細資訊,請參閱 System.Guid(String)。
在沒有字串輸入或 Empty 參數的情況下使用時,Cmdlet 會建立第 4 版通用唯一標識碼 (UUID)。 如需詳細資訊,請參閱 System.Guid.NewGuid。