New-Guid
Tworzy identyfikator GUID.
Składnia
Default (Domyślna)
New-Guid
[<CommonParameters>]
Empty
New-Guid
[-Empty]
[<CommonParameters>]
InputObject
New-Guid
[-InputObject <String>]
[<CommonParameters>]
Opis
Polecenie cmdlet New-Guid tworzy losowy unikatowy identyfikator globalny (GUID). Jeśli potrzebujesz unikatowego identyfikatora w skrypcie, możesz utworzyć identyfikator GUID według potrzeb.
Przykłady
Przykład 1. Tworzenie nowego identyfikatora GUID
New-Guid
To polecenie tworzy losowy identyfikator GUID (Globalny Unikalny Identyfikator). 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 z ciągu
Przykład ten konwertuje 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
Ten przykład konwertuje ciągi z potoku danych 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 ten cmdlet tworzy pusty identyfikator GUID. Pusty identyfikator GUID składa się z samych zer w ciągu znaków.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Empty
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-InputObject
Ten parametr akceptuje ciąg reprezentujący identyfikator GUID i konwertuje go na obiekt GUID.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
InputObject
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wyjściowe
Guid
To polecenie cmdlet zwraca identyfikator GUID.
Uwagi
Polecenie cmdlet przekazuje dane wejściowe typu string 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 parametru Empty polecenie cmdlet tworzy uniwersalny unikatowy identyfikator (UUID) w wersji 4. Aby uzyskać więcej informacji, zobacz System.Guid.NewGuid.
