New-Guid

Referência

Módulo:: Microsoft.PowerShell.Utility

Cria um GUID.

Sintaxe

New-Guid []

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

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

Description

O cmdlet New-Guid cria um GUID (identificador global exclusivo) aleatório. Se você precisar de um ID exclusivo em um script, poderá criar um GUID, conforme necessário.

Exemplos

Exemplo 1: Criar um novo GUID

New-Guid

Este comando cria um GUID aleatório. Como alternativa, você pode armazenar a saída desse cmdlet em uma variável para usar em outro lugar em um script.

Exemplo 2: Criar um GUID vazio

New-Guid -Empty

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

Exemplo 3: Criar um GUID a partir de uma cadeia de caracteres

Este exemplo converte uma cadeia de caracteres que contém um GUID em um objeto GUID.

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

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

Exemplo 4: Converter cadeias de caracteres do pipeline em GUIDs

Este exemplo converte cadeias de caracteres do pipeline em 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 esse cmdlet cria um GUID vazio. Um GUID vazio tem todos os zeros em sua cadeia de caracteres.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-InputObject

Este parâmetro aceita uma cadeia de caracteres que representa um GUID e a converte em um objeto GUID.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

Saídas

Guid

Este cmdlet retorna um GUID.

Notas

O cmdlet passa a entrada de cadeia de caracteres para o construtor da classe System.Guid. O construtor suporta strings em vários formatos. Para obter mais informações, consulte System.Guid(String).

Quando usado sem entrada de cadeia de caracteres ou o parâmetro Empty, o cmdlet cria um UUID (Universally Unique Identifier) da Versão 4. Para obter mais informações, consulte System.Guid.NewGuid.

Partilhar via