New-AzDiskConfig

  • Başvuru
Modül:
Az.Compute

Yapılandırılabilir bir disk nesnesi oluşturur.

Syntax

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>]

Description

New-AzDiskConfig cmdlet'i yapılandırılabilir bir disk nesnesi oluşturur.

Örnekler

Örnek 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;

İlk komut, Standard_LRS depolama hesabı türünde boyutu 5 GB olan yerel boş bir disk nesnesi oluşturur. Ayrıca Windows işletim sistemi türünü ayarlar ve şifreleme ayarlarını etkinleştirir. İkinci ve üçüncü komutlar, disk nesnesi için disk şifreleme anahtarı ve anahtar şifreleme anahtarı ayarlarını ayarlar. Son komut disk nesnesini alır ve 'ResourceGroup01' kaynak grubunda 'Disk01' adlı bir disk oluşturur.

Örnek 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'

İlk komut, Karşıya Yükleme için yerel bir disk nesnesi oluşturur. İkinci komut disk nesnesini alır ve 'ResourceGroup01' kaynak grubunda 'Disk01' adlı bir disk oluşturur. Üçüncü komut disk için SAS Url'sini alır. Dördüncü komut diskin durumunu alır. Disk durumu 'ReadyToUpload' ise, kullanıcı AzCopy kullanarak blob depolamadan disk SAS Url'sine disk yükleyebilir. Karşıya yükleme sırasında disk durumu 'ActiveUpload' olarak değiştirilir. Son komut SAS Url'si için disk erişimini iptal eder.

Örnek 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

Paylaşılan Galeri Görüntü Sürümünden bir disk oluşturun. Kimlik, paylaşılan galeri görüntüsü sürümünün kimliğidir. Lun yalnızca kaynak bir veri diskiyse gereklidir.

Örnek 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

Bir sanal makineden sık sık (günde 5 kereden fazla) ayrılacak ve başka bir sanal makineye bağlanacak veri disklerinin güvenilirliğini ve performansını artırmak için OptimizedForFrequentAttach true olarak bir disk oluşturun.

Parametreler

-AcceleratedNetwork

İşletim sistemi diskinin oluşturulduğu görüntü hızlandırılmış ağı destekliyorsa true.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Architecture

İşletim sistemi diski tarafından desteklenen CPU mimarisi. Olası değerler "X64" ve "Arm64" şeklindedir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-BurstingEnabled

Diskin sağlanan performans hedefinin ötesinde patlamaya olanak tanır. Seri artış varsayılan olarak devre dışıdır. Ultra diskler için geçerli değildir.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CreateOption

Bu cmdlet'in sanal makinede bir platformdan veya kullanıcı görüntüsünden disk oluşturup oluşturmadığını, boş disk oluşturup oluşturmadığını veya var olan bir diski ekleyip eklemediğini belirtir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DataAccessAuthMode

Diske veya anlık görüntüye dışarı aktarma veya karşıya yükleme sırasında ek kimlik doğrulama gereksinimleri.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskAccessId

Üzerinde özel uç noktaları kullanmak için DiskAccess kaynağının ARM kimliğini alır veya ayarlar.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskEncryptionKey

Disk üzerindeki disk şifreleme anahtarı nesnesini belirtir.

Type:KeyVaultAndSecretReference
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskEncryptionSetId

Bekleyen şifrelemeyi etkinleştirmek için kullanılacak disk şifreleme kümesinin kaynak kimliğini belirtir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskIOPSReadOnly

Paylaşılan diski ReadOnly olarak takan tüm VM'lerde izin verilecek toplam IOPS sayısı. Bir işlem 4k ile 256k bayt arasında aktarım yapabilir.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskIOPSReadWrite

Bu disk için izin verilen IOPS sayısı; yalnızca UltraSSD diskler için ayarlanabilir. Bir işlem 4k ile 256k bayt arasında aktarım yapabilir.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskMBpsReadOnly

Paylaşılan diski ReadOnly olarak bağlamak için tüm VM'lerde izin verilecek toplam aktarım hızı (MB/sn). MB/sn, saniyede milyonlarca bayt anlamına gelir. Burada MB değeri, 10'un gücünün ISO gösterimini kullanır.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskMBpsReadWrite

Bu disk için izin verilen bant genişliği; yalnızca UltraSSD diskler için ayarlanabilir. MB/sn, saniyede milyonlarca bayt anlamına gelir. Burada MB değeri, 10'un gücünün ISO gösterimini kullanır.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskSizeGB

Diskin gb cinsinden boyutunu belirtir.

Type:Int32
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EdgeZone

Kenar bölgesi adını ayarlar. Ayarlanırsa, sorgu ana bölge yerine belirtilen edgezone'a yönlendirilir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EncryptionSettingsEnabled

Şifreleme ayarlarını etkinleştirin.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EncryptionType

Diskin verilerini şifrelemek için kullanılan anahtar türü. Kullanılabilir değerler şunlardır: 'EncryptionAtRestWithPlatformKey', 'EncryptionAtRestWithCustomerKey'

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-GalleryImageReference

GalleryImageReference nesnesi. Galeri Görüntüsünden oluşturuluyorsa gereklidir. Kimlik, diskin oluşturulacağı paylaşılan kadırga görüntüsü sürümünün ARM kimliği olacaktır. Kopyanın kaynağı galeri görüntüsündeki veri disklerinden biriyse lun gereklidir; null ise, görüntünün işletim sistemi diski kopyalanır.

Type:ImageDiskReference
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-HyperVGeneration

Sanal Makinenin hiper yönetici oluşturması. Yalnızca işletim sistemi diskleri için geçerlidir. İzin verilen değerler V1 ve V2'dir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageReference

Disk üzerindeki görüntü başvurularını belirtir. Kimlik, diskin oluşturulacağı PIR veya kullanıcı görüntüsünün ARM kimliği olacaktır. Kopyanın kaynağı galeri görüntüsündeki veri disklerinden biriyse lun gereklidir; null ise, görüntünün işletim sistemi diski kopyalanır.

Type:ImageDiskReference
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-KeyEncryptionKey

Diskte Anahtar şifreleme anahtarını belirtir.

Type:KeyVaultAndKeyReference
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Bir konum belirtir.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LogicalSectorSize

Ultra diskler için bayt cinsinden mantıksal kesim boyutu.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxSharesCount

Diske aynı anda eklenebilen vm sayısı üst sınırı. Birden büyük değer, aynı anda birden çok VM'ye bağlanabilen bir diski gösterir.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NetworkAccessPolicy

Ağ erişim ilkesi, ağ erişim ilkesini tanımlar. Olası değerler şunlardır: 'AllowAll', 'AllowPrivate', 'DenyAll'

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OptimizedForFrequentAttach

Bu özelliği true olarak ayarlamak, bir sanal makineden ayrılıp başka bir sanal makineye bağlı olarak sık sık (günde 5 kereden fazla) olan veri disklerinin güvenilirliğini ve performansını artırır. Bu özellik, disklerin sanal makinenin hata etki alanıyla hizalanmamalarına neden olduğundan, ayrılmamış ve sık sık bağlı olmayan diskler için ayarlanmamalıdır.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OsType

İşletim sistemi türünü belirtir.

Type:Nullable<T>[OperatingSystemTypes]
Accepted values:Windows, Linux
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PerformancePlus

Dağıtılan diskin performans hedefini artırmak için bu bayrağı true olarak ayarlayın, ilgili performans hedefi için buraya bakın. Bu bayrak yalnızca disk oluşturma zamanında ayarlanabilir ve etkinleştirildikten sonra devre dışı bırakılamaz.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicNetworkAccess

Diskte dışarı aktarmayı denetleme ilkesi.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PurchasePlan

Disk için Satın Alma Planı'nı belirtir.

Type:PSPurchasePlan
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SkuName

Depolama hesabının Sku adını belirtir. Kullanılabilir değerler Standard_LRS, Premium_LRS, StandardSSD_LRS ve UltraSSD_LRS, Premium_ZRS ve StandardSSD_ZRS'dır. UltraSSD_LRS yalnızca CreateOption parametresi için Boş değerle kullanılabilir.

Type:String
Aliases:AccountType
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SourceResourceId

Kaynak kaynak kimliğini belirtir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SourceUri

Kaynak Uri'yi belirtir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountId

Depolama hesabı kimliğini belirtir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SupportsHibernation

Müşteriler Diskte SupportsHibernation bayrağını ayarlayabilir.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Karma tablo biçiminde anahtar-değer çiftleri. Örneğin: @{key0="value0"; key1=$null; key2="value2"}

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tier

Diskin performans katmanı.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UploadSizeInBytes

CreateOption Karşıya Yükle olduğunda VHD alt bilgisi de dahil olmak üzere karşıya yükleme içeriğinin boyutunu belirtir. Bu değer 20972032 (VHD alt bilgisi için 20 MiB + 512 bayt) ile 35183298347520 bayt (VHD alt bilgisi için 32 TiB + 512 bayt) arasında olmalıdır.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Disk için mantıksal bölge listesini belirtir.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Girişler

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

Çıkışlar

PSDisk