New-Guid

Modul:

Microsoft.PowerShell.Utility

Vytvoří identifikátor GUID.

Syntaxe

PowerShell

New-Guid []

PowerShell

New-Guid
   [-Empty]
   [<CommonParameters>]

PowerShell

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

PowerShell

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

PowerShell

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.

PowerShell

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.

PowerShell

$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

Guid

Tato rutina vrátí identifikátor GUID.

Poznámky

Rutina 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.