Compartir a través de


New-Guid

Crea un GUID.

Sintaxis

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

Description

El cmdlet New-Guid crea un identificador único global aleatorio (GUID). Si necesita un identificador único en un script, puede crear un GUID, según sea necesario.

Ejemplos

Ejemplo 1: Creación de un GUID

New-Guid

Este comando crea un GUID aleatorio. Como alternativa, puede almacenar la salida de este cmdlet en una variable para usarla en otro lugar de un script.

Ejemplo 2: Creación de un GUID vacío

New-Guid -Empty

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

Ejemplo 3: Creación de un GUID a partir de una cadena

En este ejemplo se convierte una cadena que contiene un GUID en un objeto GUID.

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

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

Ejemplo 4: Conversión de cadenas de la canalización a GUID

En este ejemplo se convierten cadenas de la canalización en objetos 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

Parámetros

-Empty

Indica que este cmdlet crea un GUID vacío. Un GUID vacío tiene todos los ceros en su cadena.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Este parámetro acepta una cadena que representa un GUID y la convierte en un objeto GUID.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

Guid

Este cmdlet devuelve un GUID.

Notas

El cmdlet pasa la entrada de cadena al constructor de la clase System.Guid. El constructor admite cadenas en varios formatos. Para obtener más información, vea System.Guid(String).

Cuando se usa sin entrada de cadena o el parámetro Empty, el cmdlet crea un identificador único universal (UUID) de la versión 4. Para obtener más información, vea System.Guid.NewGuid.