New-Guid
Vytvoří identifikátor GUID.
Syntaxe
Default (Výchozí)
New-Guid
[<CommonParameters>]
Empty
New-Guid
[-Empty]
[<CommonParameters>]
InputObject
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 GUIDu
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 toku dat na identifikátory GUID
Tento příklad konvertuje ř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 tento cmdlet vytvoří prázdný GUID. Prázdný identifikátor GUID má v řetězci všechny nuly.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Empty
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Tento parametr přijímá řetězec představující identifikátor GUID a převede ho na objekt GUID.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
InputObject
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Výstupy
Guid
Tento cmdlet vrátí GUID.
Poznámky
Cmdlet předá řetězcový vstup 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 parametru Empty vytvoří rutina univerzální jedinečný identifikátor (UUID) verze 4. Další informace naleznete v tématu System.Guid.NewGuid.
