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 |
Входные данные
Nullable<T>[[Microsoft.Azure.Management.Compute.Models.OperatingSystemTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
String[]
Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]