Condividi tramite


New-Guid

Crea un GUID.

Sintassi

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

Descrizione

Il cmdlet New-Guid crea un identificatore univoco globale casuale (GUID). Se è necessario un ID univoco in uno script, è possibile creare un GUID in base alle esigenze.

Esempio

Esempio 1: Creare un nuovo GUID

New-Guid

Questo comando crea un GUID casuale. In alternativa, è possibile archiviare l'output di questo cmdlet in una variabile da usare altrove in uno script.

Esempio 2: Creare un GUID vuoto

New-Guid -Empty

Guid
----
00000000-0000-0000-0000-000000000000

Esempio 3: Creare un GUID da una stringa

In questo esempio viene convertita una stringa contenente un GUID in un oggetto GUID.

New-Guid -InputObject "d61bbeca-0186-48fa-90e1-ff7aa5d33e2d"

Guid
----
d61bbeca-0186-48fa-90e1-ff7aa5d33e2d

Esempio 4: Convertire stringhe dalla pipeline in GUID

In questo esempio vengono convertite stringhe dalla pipeline in oggetti 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

Parametri

-Empty

Indica che questo cmdlet crea un GUID vuoto. Un GUID vuoto ha tutti gli zeri nella stringa.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Questo parametro accetta una stringa che rappresenta un GUID e la converte in un oggetto GUID.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Output

Guid

Questo cmdlet restituisce un GUID.

Note

Il cmdlet passa l'input stringa al costruttore della classe System.Guid. Il costruttore supporta stringhe in diversi formati. Per altre informazioni, vedere System.Guid(String).

Se usato senza input stringa o il parametro Empty, il cmdlet crea un identificatore univoco universale versione 4 (UUID). Per altre informazioni, vedere System.Guid.NewGuid.