New-Guid

Moduł:

Microsoft.PowerShell.Utility

Tworzy identyfikator GUID.

Składnia

New-Guid []

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

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

Opis

Polecenie New-Guid cmdlet tworzy losowy unikatowy identyfikator globalny (GUID). Jeśli potrzebujesz unikatowego identyfikatora skryptu, możesz w razie potrzeby utworzyć identyfikator GUID.

Przykłady

Przykład 1. Tworzenie nowego identyfikatora GUID

New-Guid

To polecenie tworzy losowy identyfikator GUID. Alternatywnie można przechowywać dane wyjściowe tego polecenia cmdlet w zmiennej, aby użyć w innym miejscu skryptu.

Przykład 2. Tworzenie pustego identyfikatora GUID

New-Guid -Empty

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

Przykład 3. Tworzenie identyfikatora GUID na podstawie ciągu

W tym przykładzie jest konwertowany ciąg zawierający identyfikator GUID na obiekt GUID.

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

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

Przykład 4. Konwertowanie ciągów z potoku na identyfikatory GUID

W tych przykładach ciągi są konwertowane z potoku na obiekty 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

Parametry

-Empty

Wskazuje, że to polecenie cmdlet tworzy pusty identyfikator GUID. Pusty identyfikator GUID zawiera wszystkie zera w ciągu.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-InputObject

Ten parametr akceptuje ciąg reprezentujący identyfikator GUID i konwertuje go na obiekt GUID.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

Dane wyjściowe

Guid

To polecenie cmdlet zwraca identyfikator GUID.

Uwagi

Polecenie cmdlet przekazuje dane wejściowe ciągu do konstruktora klasy System.Guid . Konstruktor obsługuje ciągi w kilku formatach. Aby uzyskać więcej informacji, zobacz System.Guid(String).

W przypadku użycia bez danych wejściowych ciągu lub pustego parametru polecenie cmdlet tworzy uniwersalny unikatowy identyfikator (UUID) w wersji 4. Aby uzyskać więcej informacji, zobacz System.Guid.NewGuid.