Dela via

New-Guid

Modul:
Microsoft.PowerShell.Utility Module

Skapar ett GUID.

Syntax

Default (Standard) 

New-Guid
    [<CommonParameters>]

Empty 

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

InputObject 

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

Description

Cmdleten New-Guid skapar en slumpmässig globalt unik identifierare (GUID). Om du behöver ett unikt ID i ett skript kan du skapa ett GUID efter behov.

Exempel

Exempel 1: Skapa ett nytt GUID

New-Guid

Det här kommandot skapar ett slumpmässigt GUID. Du kan också lagra utdata från den här cmdleten i en variabel som ska användas någon annanstans i ett skript.

Exempel 2: Skapa ett tomt GUID

New-Guid -Empty

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

Exempel 3: Skapa ett GUID från en sträng

I det här exemplet konverteras en sträng som innehåller ett GUID till ett GUID-objekt.

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

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

Exempel 4: Konvertera strängar från pipelinen till GUID

I det här exemplet konverteras strängar från pipelinen till GUID-objekt.

$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

Parametrar

-Empty

Anger att den här cmdleten skapar ett tomt GUID. Ett tomt GUID har alla nollor i strängen.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Empty
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-InputObject

Den här parametern accepterar en sträng som representerar ett GUID och konverterar den till ett GUID-objekt.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

InputObject
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Utdata

Guid

Den här cmdleten returnerar ett GUID.

Kommentarer

Cmdleten skickar strängindata till konstruktorn för klassen System.Guid. Konstruktorn stöder strängar i flera format. Mer information finns i System.Guid(String).

När den används utan strängindata eller parametern Tom skapar cmdleten en UUID (Version 4 Universally Unique Identifier). Mer information finns i System.Guid.NewGuid.