Поделиться через

New-Guid

Модуль:
Microsoft.PowerShell.Utility Module

Создает GUID.

Синтаксис

Default (по умолчанию) 

New-Guid
    [<CommonParameters>]

Empty 

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

InputObject 

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

Описание

Командлет New-Guid создает случайный глобально уникальный идентификатор (GUID). Если вам нужен уникальный идентификатор в скрипте, вы можете создать GUID по мере необходимости.

Примеры

Пример 1. Создание нового GUID

New-Guid

Эта команда создает случайный GUID. В качестве альтернативы, можно сохранить выходные данные этого командлета в переменной для дальнейшего использования в скрипте.

Пример 2. Создание пустого GUID

New-Guid -Empty

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

Пример 3. Создание GUID из строки

В этом примере строка, содержащая GUID, преобразуется в объект GUID.

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

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

Пример 4. Преобразование строк из конвейера в графические идентификаторы

В этом примере строки из конвейера преобразуются в объекты 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

Параметры

-Empty

Указывает, что этот командлет создает пустой GUID. Пустой GUID содержит все нули в строке.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Empty
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-InputObject

Этот параметр принимает строку, представляющую GUID, и преобразует ее в объект GUID.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

InputObject
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Выходные данные

Guid

Этот командлет возвращает GUID.

Примечания

Командлет передает строковые входные данные конструктору класса System.Guid. Конструктор поддерживает строки в нескольких форматах. Дополнительные сведения см. в System.Guid(String).

При использовании без строковых входных данных или пустого параметра командлет создает универсальный уникальный идентификатор версии 4 (UUID). Дополнительные сведения см. в разделе System.Guid.NewGuid.