New-Guid
Vytvoří identifikátor GUID.
Syntaxe
New-Guid []
New-Guid
[-Empty]
[<CommonParameters>]
New-Guid
[-InputObject <String>]
[<CommonParameters>]
Description
Rutina New-Guid
vytvoří náhodný globálně jedinečný identifikátor (GUID). Pokud potřebujete jedinečné ID ve skriptu, můžete podle potřeby vytvořit identifikátor GUID.
Příklady
Příklad 1: Vytvoření nového identifikátoru GUID
New-Guid
Tento příkaz vytvoří náhodný identifikátor GUID. Případně můžete výstup této rutiny uložit do proměnné, která se použije jinde ve skriptu.
Příklad 2: Vytvoření prázdného identifikátoru GUID
New-Guid -Empty
Guid
----
00000000-0000-0000-0000-000000000000
Příklad 3: Vytvoření identifikátoru GUID z řetězce
Tento příklad převede řetězec obsahující identifikátor GUID na objekt GUID.
New-Guid -InputObject "d61bbeca-0186-48fa-90e1-ff7aa5d33e2d"
Guid
----
d61bbeca-0186-48fa-90e1-ff7aa5d33e2d
Příklad 4: Převod řetězců z kanálu na identifikátory GUID
Tento příklad převede řetězce z kanálu na objekty 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
Parametry
-Empty
Označuje, že tato rutina vytvoří prázdný identifikátor GUID. Prázdný identifikátor GUID má v řetězci všechny nuly.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-InputObject
Tento parametr přijímá řetězec představující identifikátor GUID a převede ho na objekt GUID.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
Výstupy
Tato rutina vrátí identifikátor GUID.
Poznámky
Rutina předává řetězcový vstup do konstruktoru třídy System.Guid . Konstruktor podporuje řetězce v několika formátech. Další informace naleznete v tématu System.Guid(String).
Při použití bez zadání řetězce nebo prázdného parametru vytvoří rutina univerzální jedinečný identifikátor (UUID) verze 4. Další informace naleznete v tématu System.Guid.NewGuid.