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 |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Architecture
Архитектура ЦП, поддерживаемая диском ОС. Возможные значения: X64 и Arm64.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-BurstingEnabled
Обеспечивает ускорение за пределами подготовленного целевого объекта производительности диска. Ускорение отключено по умолчанию. Не применяется к дискам Категории "Ультра".
Тип: | Nullable<T>[Boolean] |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CreateOption
Указывает, создает ли этот командлет диск на виртуальной машине из платформы или пользовательского образа, создает пустой диск или подключает существующий диск.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DataAccessAuthMode
Дополнительные требования к проверке подлинности при экспорте или отправке на диск или моментальный снимок.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Тип: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskAccessId
Возвращает или задает идентификатор ARM ресурса DiskAccess для использования частных конечных точек.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskEncryptionKey
Указывает объект ключа шифрования диска на диске.
Тип: | KeyVaultAndSecretReference |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskEncryptionSetId
Указывает идентификатор ресурса набора шифрования дисков, используемый для включения шифрования неактивных данных.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskIOPSReadOnly
Общее количество операций ввода-вывода в секунду, которое будет разрешено во всех виртуальных машинах, которые будут подключать общий диск как ReadOnly. Одна операция может передаваться между 4k и 256 кб байтами.
Тип: | Int64 |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskIOPSReadWrite
Количество операций ввода-вывода в секунду, разрешенных для этого диска; только для дисков UltraSSD. Одна операция может передаваться между 4k и 256 кб байтами.
Тип: | Int64 |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskMBpsReadOnly
Общая пропускная способность (МБ пс), которая будет разрешена для всех виртуальных машин, которые будут подключать общий диск как ReadOnly. МБ ps означает миллионы байтов в секунду - МБ здесь использует нотацию ISO, из 10.
Тип: | Int64 |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskMBpsReadWrite
Пропускная способность, разрешенная для этого диска; только для дисков UltraSSD. МБ ps означает миллионы байтов в секунду - МБ здесь использует нотацию ISO, из 10.
Тип: | Int64 |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskSizeGB
Указывает размер диска в ГБ.
Тип: | Int32 |
Position: | 2 |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EdgeZone
Задает имя граничной зоны. Если задано, запрос будет перенаправлен в указанную зону edge, а не в основной регион.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncryptionSettingsEnabled
Включите параметры шифрования.
Тип: | Nullable<T>[Boolean] |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncryptionType
Тип ключа, используемого для шифрования данных диска. Доступные значения: EncryptionAtRestWithPlatformKey, EncryptionAtRestWithCustomerKey
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-GalleryImageReference
Объект GalleryImageReference. Требуется при создании из образа коллекции. Идентификатор будет идентификатором ARM общей версии образа галли, из которой создается диск. Луна необходима, если источник копии является одним из дисков данных в образе коллекции; Если значение NULL, диск ОС образа будет скопирован.
Тип: | ImageDiskReference |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HyperVGeneration
Создание гипервизора виртуальной машины. Применимо только к дискам ОС. Допустимые значения: V1 и V2.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageReference
Указывает ссылку на образ на диске. Идентификатор будет идентификатором ARM образа ПИР или пользователя, из которого создается диск. LuN требуется, если источник копии является одним из дисков данных в образе коллекции; Если значение NULL, диск ОС образа будет скопирован.
Тип: | ImageDiskReference |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-KeyEncryptionKey
Указывает ключ шифрования ключей на диске.
Тип: | KeyVaultAndKeyReference |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
Указывает расположение.
Тип: | String |
Position: | 3 |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LogicalSectorSize
Размер логического сектора в байтах для дисков Категории "Ультра".
Тип: | Int32 |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MaxSharesCount
Максимальное количество виртуальных машин, которые могут подключаться к диску одновременно. Значение больше одного указывает на диск, который может быть подключен на нескольких виртуальных машинах одновременно.
Тип: | Int32 |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NetworkAccessPolicy
Политика доступа к сети определяет политику доступа к сети. Возможные значения: AllowAll, AllowPrivate, DenyAll
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OptimizedForFrequentAttach
При установке этого свойства значение true повышает надежность и производительность дисков данных, которые часто (более 5 раз в день) отсоединяются от одной виртуальной машины и подключены к другой. Это свойство не должно быть задано для дисков, которые не отсоединяются и подключаются часто, так как диски не соответствуют домену сбоя виртуальной машины.
Тип: | Nullable<T>[Boolean] |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OsType
Указывает тип ОС.
Тип: | Nullable<T>[OperatingSystemTypes] |
допустимые значения: | Windows, Linux |
Position: | 1 |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PerformancePlus
Задайте для этого флага значение true, чтобы повысить производительность целевого объекта развернутого диска, см. здесь по соответствующему целевому объекту производительности. Этот флаг можно задать только во время создания диска и не может быть отключен после включения.
Тип: | Nullable<T>[Boolean] |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublicNetworkAccess
Политика управления экспортом на диске.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PurchasePlan
Указывает план покупки диска.
Тип: | PSPurchasePlan |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkuName
Указывает имя SKU учетной записи хранения. Доступные значения: Standard_LRS, Premium_LRS, StandardSSD_LRS и UltraSSD_LRS, Premium_ZRS и StandardSSD_ZRS. UltraSSD_LRS можно использовать только с пустым значением для параметра CreateOption.
Тип: | String |
Aliases: | AccountType |
Position: | 0 |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceResourceId
Указывает идентификатор исходного ресурса.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceUri
Указывает исходный универсальный код ресурса (URI).
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountId
Указывает идентификатор учетной записи хранения.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SupportsHibernation
Клиенты могут задать флаг ПоддержкиHibernation на диске.
Тип: | Nullable<T>[Boolean] |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Пары "ключ-значение" в виде хэш-таблицы. Например: @{key0="value0"; key1=$null; key2="value2"}
Тип: | Hashtable |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tier
Уровень производительности диска.
Тип: | String |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UploadSizeInBytes
Задает размер содержимого отправки, включая нижний колонтитул VHD при отправке CreateOption. Это значение должно быть от 20972032 (20 МиБ + 512 байт для нижнего колонтитула VHD) и 35183298347520 байт (32 ТиБ + 512 байт для нижнего колонтитула VHD).
Тип: | Int64 |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Zone
Указывает список логических зон для диска.
Тип: | String[] |
Position: | Named |
значение по умолчанию: | None |
Обязательно: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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]]
Выходные данные
Azure PowerShell
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по