New-Guid
Creates a GUID.
Sintassi
Default (impostazione predefinita).
New-Guid
[<CommonParameters>]
Empty
New-Guid
[-Empty]
[<CommonParameters>]
InputObject
New-Guid
[-InputObject <String>]
[<CommonParameters>]
Descrizione
The New-Guid cmdlet creates a random globally unique identifier (GUID). If you need a unique ID in
a script, you can create a GUID, as needed.
Esempio
Example 1: Create a new GUID
New-Guid
This command creates a random GUID. Alternatively, you could store the output of this cmdlet in a variable to use elsewhere in a script.
Example 2: Create an empty GUID
New-Guid -Empty
Guid
----
00000000-0000-0000-0000-000000000000
Example 3: Create a GUID from a string
This example converts a string that contains a GUID to a GUID object.
New-Guid -InputObject "d61bbeca-0186-48fa-90e1-ff7aa5d33e2d"
Guid
----
d61bbeca-0186-48fa-90e1-ff7aa5d33e2d
Example 4: Convert strings from the pipeline to GUIDs
This examples converts strings from the pipeline to GUID objects.
$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
Parametri
-Empty
Indicates that this cmdlet creates an empty GUID. An empty GUID has all zeros in its string.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Empty
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-InputObject
This parameter accepts a string representing a GUID and converts it to a GUID object.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
InputObject
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Output
Guid
This cmdlet returns a GUID.
Note
The cmdlet passes string input to the constructor of the System.Guid class. The constructor support strings in several formats. For more information, see System.Guid(String).
When used without string input or the Empty parameter, the cmdlet creates a Version 4 Universally Unique Identifier (UUID). For more information, see System.Guid.NewGuid.
