Aracılığıyla paylaş

New-AzDiskConfig

  • Başvuru
Modül:
Az.Compute

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

Sözdizimi

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.

Tür:Nullable<T>[Boolean]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Architecture

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

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:Nullable<T>[Boolean]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Confirm

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

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DefaultProfile

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

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DiskAccessId

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

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DiskEncryptionKey

Disk üzerindeki disk şifreleme anahtarı nesnesini belirtir.

Tür:KeyVaultAndSecretReference
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DiskEncryptionSetId

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

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:Int64
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:Int64
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:Int64
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:Int64
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DiskSizeGB

Diskin gb cinsinden boyutunu belirtir.

Tür:Int32
Position:2
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-EdgeZone

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

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-EncryptionSettingsEnabled

Şifreleme ayarlarını etkinleştirin.

Tür:Nullable<T>[Boolean]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-EncryptionType

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

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:ImageDiskReference
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:ImageDiskReference
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-KeyEncryptionKey

Diskte Anahtar şifreleme anahtarını belirtir.

Tür:KeyVaultAndKeyReference
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Location

Bir konum belirtir.

Tür:String
Position:3
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-LogicalSectorSize

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

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-NetworkAccessPolicy

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

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:Nullable<T>[Boolean]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-OsType

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

Tür:Nullable<T>[OperatingSystemTypes]
Kabul edilen değerler:Windows, Linux
Position:1
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:Nullable<T>[Boolean]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-PublicNetworkAccess

Diskte dışarı aktarmayı denetleme ilkesi.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-PurchasePlan

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

Tür:PSPurchasePlan
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:String
Diğer adlar:AccountType
Position:0
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-SourceResourceId

Kaynak kaynak kimliğini belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-SourceUri

Kaynak Uri'yi belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-StorageAccountId

Depolama hesabı kimliğini belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-SupportsHibernation

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

Tür:Nullable<T>[Boolean]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Tag

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

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Tier

Diskin performans katmanı.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et: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.

Tür:Int64
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WhatIf

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

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Zone

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

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

Girişler

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

Çıkışlar