你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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 cmdlet 创建可配置的磁盘对象。

示例

示例 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;

第一个命令在Standard_LRS存储帐户类型中创建大小为 5GB 的本地空磁盘对象。 它还设置 Windows OS 类型并启用加密设置。 第二和第三个命令设置磁盘对象的磁盘加密密钥和密钥加密密钥设置。 最后一个命令采用磁盘对象,并在资源组“ResourceGroup01”中创建名为“Disk01”的磁盘。

示例 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'

第一个命令为 Upload 创建本地磁盘对象。 第二个命令采用磁盘对象,并在资源组“ResourceGroup01”中创建名为“Disk01”的磁盘。 第三个命令获取磁盘的 SAS URL。 第四个命令获取磁盘的状态。 如果磁盘状态为“ReadyToUpload”,则用户可以使用 AzCopy 将磁盘从 Blob 存储上传到磁盘 SAS URL。 上传期间,磁盘状态将更改为“ActiveUpload”。 最后一个命令撤销 SAS URL 的磁盘访问权限。

示例 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

从共享库映像版本创建磁盘。 ID 是共享库映像版本的 ID。 仅当源是数据磁盘时,才需要 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

创建一个磁盘,将 OptimizedForFrequentAttach 设置为 true,以提高数据磁盘的可靠性和性能,该磁盘通常(每天超过 5 次)从一个虚拟机分离并附加到另一个虚拟机。

参数

-AcceleratedNetwork

如此 如果从中创建 OS 磁盘的映像支持加速网络。

类型:Nullable<T>[Boolean]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Architecture

OS 磁盘支持的 CPU 体系结构。 可能的值为“X64”和“Arm64”。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-BurstingEnabled

启用超出磁盘预配性能目标的突发。 默认情况下,突发处于禁用状态。 不适用于超级磁盘。

类型:Nullable<T>[Boolean]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CreateOption

指定此 cmdlet 是否从平台或用户映像在虚拟机中创建磁盘、创建空磁盘或附加现有磁盘。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DataAccessAuthMode

导出或上传到磁盘或快照时的其他身份验证要求。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DiskAccessId

获取或设置用于使用专用终结点的 DiskAccess 资源的 ARM ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DiskEncryptionKey

指定磁盘上的磁盘加密密钥对象。

类型:KeyVaultAndSecretReference
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DiskEncryptionSetId

指定用于启用静态加密的磁盘加密集的资源 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DiskIOPSReadOnly

将允许在所有 VM 中以 ReadOnly 身份装载共享磁盘的 IOPS 总数。 一个操作可以在 4k 到 256k 字节之间传输。

类型:Int64
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DiskIOPSReadWrite

此磁盘允许的 IOPS 数;只能为 UltraSSD 磁盘设置。 一个操作可以在 4k 到 256k 字节之间传输。

类型:Int64
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DiskMBpsReadOnly

所有装载共享磁盘的 VM(MBps)的总吞吐量(MBps)将作为 ReadOnly 装载。 MBps 表示每秒数百万字节 - 此处的 MB 使用 ISO 表示法,其幂为 10。

类型:Int64
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DiskMBpsReadWrite

此磁盘允许的带宽;只能为 UltraSSD 磁盘设置。 MBps 表示每秒数百万字节 - 此处的 MB 使用 ISO 表示法,其幂为 10。

类型:Int64
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DiskSizeGB

指定磁盘的大小(以 GB 为单位)。

类型:Int32
Position:2
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-EdgeZone

设置边缘区域名称。 如果设置,查询将路由到指定的边缘区域而不是主区域。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-EncryptionSettingsEnabled

启用加密设置。

类型:Nullable<T>[Boolean]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-EncryptionType

用于加密磁盘数据的密钥类型。 可用值为:“EncryptionAtRestWithPlatformKey”、“EncryptionAtRestWithCustomerKey”

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-GalleryImageReference

GalleryImageReference 对象。 从库映像创建时是必需的。 ID 将是要从中创建磁盘的共享大盘映像版本的 ARM ID。 如果副本的源是库映像中的数据磁盘之一,则需要 lun;如果为 null,则将复制映像的 OS 磁盘。

类型:ImageDiskReference
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-HyperVGeneration

虚拟机的虚拟机监控程序生成。 仅适用于 OS 磁盘。 允许的值为 V1 和 V2。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ImageReference

指定磁盘上的映像引用。 ID 将是要从中创建磁盘的 PIR 或用户映像的 ARM ID。 如果副本的源是库映像中的数据磁盘之一,则需要 LUN;如果为 null,则将复制映像的 OS 磁盘。

类型:ImageDiskReference
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-KeyEncryptionKey

指定磁盘上的密钥加密密钥。

类型:KeyVaultAndKeyReference
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Location

指定位置。

类型:String
Position:3
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-LogicalSectorSize

超级磁盘的逻辑扇区大小(以字节为单位)。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-MaxSharesCount

可以同时附加到磁盘的最大 VM 数。 大于一个值表示可以同时装载到多个 VM 上的磁盘。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-NetworkAccessPolicy

网络访问策略定义网络访问策略。 可能的值包括:“AllowAll”、“AllowPrivate”、“DenyAll”

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-OptimizedForFrequentAttach

将此属性设置为 true 可提高数据磁盘的可靠性和性能,这些磁盘通常(每天超过 5 次),方法是从一个虚拟机分离并附加到另一个虚拟机。 不应为未频繁分离和附加的磁盘设置此属性,因为它会导致磁盘与虚拟机的容错域不一致。

类型:Nullable<T>[Boolean]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-OsType

指定 OS 类型。

类型:Nullable<T>[OperatingSystemTypes]
接受的值:Windows, Linux
Position:1
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PerformancePlus

将此标志设置为 true 以提升部署的磁盘的性能目标,请参阅此处的相应性能目标。 此标志只能在磁盘创建时设置,在启用后不能禁用。

类型:Nullable<T>[Boolean]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PublicNetworkAccess

用于控制磁盘上的导出的策略。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PurchasePlan

指定磁盘的购买计划。

类型:PSPurchasePlan
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-SkuName

指定存储帐户的 SKU 名称。 可用值包括Standard_LRS、Premium_LRS、StandardSSD_LRS和UltraSSD_LRS、Premium_ZRS和StandardSSD_ZRS。 UltraSSD_LRS只能与 CreateOption 参数的空值一起使用。

类型:String
别名:AccountType
Position:0
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-SourceResourceId

指定源资源 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-SourceUri

指定源 URI。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-StorageAccountId

指定存储帐户 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-SupportsHibernation

客户可以在磁盘上设置 SupportsHibernation 标志。

类型:Nullable<T>[Boolean]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Tag

以哈希表的形式进行键值对。 例如:@{key0=“value0”;key1=$null;key2=“value2”}

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Tier

磁盘的性能层。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-UploadSizeInBytes

指定 CreateOption 为 Upload 时上传的内容的大小,包括 VHD 页脚。 此值应介于 20972032(VHD 页脚的 20 MiB + 512 字节)和35183298347520字节(VHD 页脚的 32 TiB + 512 字节)。

类型:Int64
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Zone

指定磁盘的逻辑区域列表。

类型:String[]
Position:Named
默认值: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