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