Bagikan melalui


New-Guid

Membuat GUID.

Sintaks

Default (Default)

New-Guid
    [<CommonParameters>]

Empty

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

InputObject

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

Deskripsi

cmdlet New-Guid membuat pengidentifikasi unik global acak (GUID). Jika Anda memerlukan ID unik dalam skrip, Anda dapat membuat GUID, sesuai kebutuhan.

Contoh

Contoh 1: Membuat GUID baru

New-Guid

Perintah ini membuat GUID acak. Atau, Anda dapat menyimpan output cmdlet ini dalam variabel untuk digunakan di tempat lain dalam skrip.

Contoh 2: Membuat GUID kosong

New-Guid -Empty
Guid
----
00000000-0000-0000-0000-000000000000

Contoh 3: Membuat GUID dari string

Contoh ini mengonversi string yang berisi GUID ke objek GUID.

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

Contoh 4: Mengonversi string dari alur ke GUID

Contoh ini mengonversi string dari alur ke objek 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

Parameter

-Empty

Menunjukkan bahwa cmdlet ini membuat GUID kosong. GUID kosong memiliki semua nol dalam stringnya.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

Empty
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-InputObject

Parameter ini menerima string yang mewakili GUID dan mengonversinya menjadi objek GUID.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

InputObject
Position:Named
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Output

Guid

Cmdlet ini mengembalikan GUID.

Catatan

Cmdlet meneruskan input string ke konstruktor kelas System.Guid. Konstruktor mendukung string dalam beberapa format. Untuk informasi selengkapnya, lihat System.Guid(String).

Saat digunakan tanpa input string atau parameter Kosongkan, cmdlet membuat Pengidentifikasi Unik Universal versi 4 (UUID). Untuk informasi selengkapnya, lihat System.Guid.NewGuid.