New-Guid

參考

模組:: Microsoft.PowerShell.Utility

建立 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

輸出

Guid

此 Cmdlet 會傳回 GUID。

備註

Cmdlet 會將字串輸入傳遞給 System.Guid 類別的建構函式。建構函式支持數種格式的字串。如需詳細資訊，請參閱 System.Guid（String）。

在沒有字串輸入或 Empty 參數的情況下使用時，Cmdlet 會建立第 4 版通用唯一標識碼（UUID）。如需詳細資訊，請參閱 System.Guid.NewGuid。

共用方式為