New-Guid
Crea un GUID.
Sintaxis
Default (Es el valor predeterminado).
New-Guid
[<CommonParameters>]
Empty
New-Guid
[-Empty]
[<CommonParameters>]
InputObject
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Empty
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-InputObject
Este parámetro acepta una cadena que representa un GUID y la convierte en un objeto GUID.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
InputObject
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
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.
