New-AzDiskConfig

Создает настраиваемый объект диска.

Синтаксис

New-AzDiskConfig
   [[-SkuName] <String>]
   [-Tier <String>]
   [-LogicalSectorSize <Int32>]
   [[-OsType] <OperatingSystemTypes>]
   [[-DiskSizeGB] <Int32>]
   [[-Location] <String>]
   [-EdgeZone <String>]
   [-PurchasePlan <PSPurchasePlan>]
   [-SupportsHibernation <Boolean>]
   [-Zone <String[]>]
   [-HyperVGeneration <String>]
   [-DiskIOPSReadWrite <Int64>]
   [-DiskMBpsReadWrite <Int64>]
   [-DiskIOPSReadOnly <Int64>]
   [-DiskMBpsReadOnly <Int64>]
   [-MaxSharesCount <Int32>]
   [-Tag <Hashtable>]
   [-CreateOption <String>]
   [-StorageAccountId <String>]
   [-ImageReference <ImageDiskReference>]
   [-GalleryImageReference <ImageDiskReference>]
   [-SourceUri <String>]
   [-SourceResourceId <String>]
   [-UploadSizeInBytes <Int64>]
   [-EncryptionSettingsEnabled <Boolean>]
   [-DiskEncryptionKey <KeyVaultAndSecretReference>]
   [-KeyEncryptionKey <KeyVaultAndKeyReference>]
   [-DiskEncryptionSetId <String>]
   [-EncryptionType <String>]
   [-DiskAccessId <String>]
   [-NetworkAccessPolicy <String>]
   [-BurstingEnabled <Boolean>]
   [-PublicNetworkAccess <String>]
   [-AcceleratedNetwork <Boolean>]
   [-DataAccessAuthMode <String>]
   [-Architecture <String>]
   [-PerformancePlus <Boolean>]
   [-OptimizedForFrequentAttach <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет New-AzDiskConfig создает настраиваемый объект диска.

Примеры

Пример 1

$diskconfig = New-AzDiskConfig -Location 'Central US' -DiskSizeGB 5 -SkuName Standard_LRS -OsType Windows -CreateOption Empty -EncryptionSettingsEnabled $true;
$secretUrl = 'https://myvault.vault-int.azure-int.net/secrets/123/';
$secretId = '/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.KeyVault/vaults/TestVault123';
$keyUrl = 'https://myvault.vault-int.azure-int.net/keys/456';
$keyId = '/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.KeyVault/vaults/TestVault456';
$diskconfig = Set-AzDiskDiskEncryptionKey -Disk $diskconfig -SecretUrl $secretUrl -SourceVaultId $secretId;
$diskconfig = Set-AzDiskKeyEncryptionKey -Disk $diskconfig -KeyUrl $keyUrl -SourceVaultId $keyId;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskconfig;

Первая команда создает локальный пустой объект диска с размером 5 ГБ в типе учетной записи хранения Standard_LRS. Он также задает тип ОС Windows и включает параметры шифрования. Вторая и третья команды задают параметры ключа шифрования диска и ключа шифрования ключа для объекта диска. Последняя команда принимает объект диска и создает диск с именем Disk01 в группе ресурсов ResourceGroup01.

Пример 2

$diskconfig = New-AzDiskConfig -Location 'Central US' -DiskSizeGB 1023 -SkuName Standard_LRS -OsType Windows -CreateOption Upload -DiskIOPSReadWrite 500 -DiskMBpsReadWrite 8;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskconfig;
$diskSas = Grant-AzDiskAccess -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -DurationInSecond 86400 -Access 'Write'
$disk = Get-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'
# $disk.DiskState == 'ReadyToUpload'
 AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:$diskSas
$disk = Get-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'
# $disk.DiskState == 'ActiveUpload'
Revoke-AzDiskAccess -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'

Первая команда создает локальный объект диска для отправки. Вторая команда принимает объект диска и создает диск с именем Disk01 в группе ресурсов ResourceGroup01. Третья команда получает URL-адрес SAS для диска. Четвертая команда получает состояние диска. Если состояние диска — ReadyToUpload, пользователь может отправить диск из хранилища BLOB-объектов в URL-адрес SAS диска с помощью AzCopy. Во время отправки состояние диска изменяется на ActiveUpload. Последняя команда отменяет доступ к диску для URL-адреса SAS.

Пример 3

$galleryImageReference = @{Id = '/subscriptions/0296790d-427c-48ca-b204-8b729bbd8670/resourceGroups/swaggertests/providers/Microsoft.Compute/galleries/swaggergallery/images/swaggerimagedef/versions/1.0.0'; Lun=1}
$diskConfig = New-AzDiskConfig -Location 'West US' -CreateOption 'FromImage' -GalleryImageReference $galleryImageReference;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskConfig

Создайте диск из версии образа общей коллекции. Идентификатор — это идентификатор версии образа общей коллекции. Lun требуется только в том случае, если источник является диском данных.

Пример 4

$diskconfig = New-AzDiskConfig -Location 'Central US' -SkuName 'Standard_LRS' -OsType 'Windows' -UploadSizeInBytes 35183298347520 -CreateOption 'Upload' -OptimizedForFrequentAttach $true
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskConfig

Создайте диск с оптимизаторомForFrequentAttach как true, чтобы повысить надежность и производительность дисков данных, которые будут часто (более 5 раз в день) отсоединяться от одной виртуальной машины и подключены к другой.

Параметры

-AcceleratedNetwork

Значение true, если образ, из которого создается диск ОС, поддерживает ускорение сети.

Тип:Nullable<T>[Boolean]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Architecture

Архитектура ЦП, поддерживаемая диском ОС. Возможные значения: X64 и Arm64.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-BurstingEnabled

Обеспечивает ускорение за пределами подготовленного целевого объекта производительности диска. Ускорение отключено по умолчанию. Не применяется к дискам Категории "Ультра".

Тип:Nullable<T>[Boolean]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CreateOption

Указывает, создает ли этот командлет диск на виртуальной машине из платформы или пользовательского образа, создает пустой диск или подключает существующий диск.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DataAccessAuthMode

Дополнительные требования к проверке подлинности при экспорте или отправке на диск или моментальный снимок.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DiskAccessId

Возвращает или задает идентификатор ARM ресурса DiskAccess для использования частных конечных точек.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DiskEncryptionKey

Указывает объект ключа шифрования диска на диске.

Тип:KeyVaultAndSecretReference
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DiskEncryptionSetId

Указывает идентификатор ресурса набора шифрования дисков, используемый для включения шифрования неактивных данных.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DiskIOPSReadOnly

Общее количество операций ввода-вывода в секунду, которое будет разрешено во всех виртуальных машинах, которые будут подключать общий диск как ReadOnly. Одна операция может передаваться между 4k и 256 кб байтами.

Тип:Int64
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DiskIOPSReadWrite

Количество операций ввода-вывода в секунду, разрешенных для этого диска; только для дисков UltraSSD. Одна операция может передаваться между 4k и 256 кб байтами.

Тип:Int64
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DiskMBpsReadOnly

Общая пропускная способность (MBps), которая будет разрешена для всех виртуальных машин, которые будут подключать общий диск как ReadOnly. MBps означает миллионы байтов в секунду - МБ здесь использует нотацию ISO, полномочия из 10.

Тип:Int64
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DiskMBpsReadWrite

Пропускная способность, разрешенная для этого диска; только для дисков UltraSSD. MBps означает миллионы байтов в секунду - МБ здесь использует нотацию ISO, полномочия из 10.

Тип:Int64
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DiskSizeGB

Указывает размер диска в ГБ.

Тип:Int32
Position:2
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-EdgeZone

Задает имя граничной зоны. Если задано, запрос будет перенаправлен в указанную зону edge, а не в основной регион.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-EncryptionSettingsEnabled

Включите параметры шифрования.

Тип:Nullable<T>[Boolean]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-EncryptionType

Тип ключа, используемого для шифрования данных диска. Доступные значения: EncryptionAtRestWithPlatformKey, EncryptionAtRestWithCustomerKey

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-GalleryImageReference

Объект GalleryImageReference. Требуется при создании из образа коллекции. Идентификатор будет идентификатором ARM общей версии образа галли, из которой создается диск. Луна необходима, если источник копии является одним из дисков данных в образе коллекции; Если значение NULL, диск ОС образа будет скопирован.

Тип:ImageDiskReference
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-HyperVGeneration

Создание гипервизора виртуальной машины. Применимо только к дискам ОС. Допустимые значения: V1 и V2.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ImageReference

Указывает ссылку на образ на диске. Идентификатор будет идентификатором ARM образа ПИР или пользователя, из которого создается диск. LuN требуется, если источник копии является одним из дисков данных в образе коллекции; Если значение NULL, диск ОС образа будет скопирован.

Тип:ImageDiskReference
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-KeyEncryptionKey

Указывает ключ шифрования ключей на диске.

Тип:KeyVaultAndKeyReference
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Location

Указывает расположение.

Тип:String
Position:3
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-LogicalSectorSize

Размер логического сектора в байтах для дисков Категории "Ультра".

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-MaxSharesCount

Максимальное количество виртуальных машин, которые могут подключаться к диску одновременно. Значение больше одного указывает на диск, который может быть подключен на нескольких виртуальных машинах одновременно.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-NetworkAccessPolicy

Политика доступа к сети определяет политику доступа к сети. Возможные значения: AllowAll, AllowPrivate, DenyAll

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-OptimizedForFrequentAttach

При установке этого свойства значение true повышает надежность и производительность дисков данных, которые часто (более 5 раз в день) отсоединяются от одной виртуальной машины и подключены к другой. Это свойство не должно быть задано для дисков, которые не отсоединяются и подключаются часто, так как диски не соответствуют домену сбоя виртуальной машины.

Тип:Nullable<T>[Boolean]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-OsType

Указывает тип ОС.

Тип:Nullable<T>[OperatingSystemTypes]
Допустимые значения:Windows, Linux
Position:1
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PerformancePlus

Задайте для этого флага значение true, чтобы повысить производительность целевого объекта развернутого диска, см. здесь по соответствующему целевому объекту производительности. Этот флаг можно задать только во время создания диска и не может быть отключен после включения.

Тип:Nullable<T>[Boolean]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PublicNetworkAccess

Политика управления экспортом на диске.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PurchasePlan

Указывает план покупки диска.

Тип:PSPurchasePlan
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SkuName

Указывает имя SKU учетной записи хранения. Доступные значения: Standard_LRS, Premium_LRS, StandardSSD_LRS и UltraSSD_LRS, Premium_ZRS и StandardSSD_ZRS. UltraSSD_LRS можно использовать только с пустым значением для параметра CreateOption.

Тип:String
Aliases:AccountType
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SourceResourceId

Указывает идентификатор исходного ресурса.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SourceUri

Указывает исходный универсальный код ресурса (URI).

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-StorageAccountId

Указывает идентификатор учетной записи хранения.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SupportsHibernation

Клиенты могут задать флаг ПоддержкиHibernation на диске.

Тип:Nullable<T>[Boolean]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Tag

Пары "ключ-значение" в виде хэш-таблицы. Например: @{key0="value0"; key1=$null; key2="value2"}

Тип:Hashtable
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Tier

Уровень производительности диска.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-UploadSizeInBytes

Задает размер содержимого отправки, включая нижний колонтитул VHD при отправке CreateOption. Это значение должно быть от 20972032 (20 МиБ + 512 байт для нижнего колонтитула VHD) и 35183298347520 байт (32 ТиБ + 512 байт для нижнего колонтитула VHD).

Тип:Int64
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Zone

Указывает список логических зон для диска.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

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

String

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.OperatingSystemTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Int32

String[]

Hashtable

ImageDiskReference

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

KeyVaultAndSecretReference

KeyVaultAndKeyReference

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

PSDisk