Sdílet prostřednictvím

New-AzDiskConfig

  • Reference
Modul:
Az.Compute

Vytvoří konfigurovatelný objekt disku.

Syntaxe

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

Rutina New-AzDiskConfig vytvoří konfigurovatelný objekt disku.

Příklady

Příklad 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;

První příkaz vytvoří objekt místního prázdného disku s velikostí 5 GB v Standard_LRS typu účtu úložiště. Nastaví také typ operačního systému Windows a povolí nastavení šifrování. Druhý a třetí příkaz nastavil šifrovací klíč disku a nastavení šifrovacího klíče klíče pro objekt disku. Poslední příkaz vezme objekt disku a vytvoří disk s názvem Disk01 ve skupině prostředků ResourceGroup01.

Příklad 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'

První příkaz vytvoří objekt místního disku pro nahrání. Druhý příkaz vezme objekt disku a vytvoří disk s názvem Disk01 ve skupině prostředků ResourceGroup01. Třetí příkaz získá adresu URL SAS disku. Čtvrtý příkaz získá stav disku. Pokud je stav disku ReadyToUpload, může uživatel nahrát disk z úložiště objektů blob do adresy URL SAS disku pomocí nástroje AzCopy. Během nahrávání se stav disku změní na ActiveUpload. Poslední příkaz odvolá přístup k disku pro adresu URL SAS.

Příklad 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

Vytvořte disk ze sdílené verze image galerie. ID je ID verze sdílené image galerie. Logická jednotka je nutná pouze v případě, že zdrojem je datový disk.

Příklad 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

Vytvořte disk s funkcí OptimizedForFrequentAttach jako true, abyste zlepšili spolehlivost a výkon datových disků, které budou často (více než 5krát denně) odpojeny od jednoho virtuálního počítače a připojené k jinému.

Parametry

-AcceleratedNetwork

Hodnota True, pokud image, ze které je disk s operačním systémem vytvořen, podporuje akcelerované síťové služby.

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Architecture

Architektura procesoru podporovaná diskem s operačním systémem Možné hodnoty jsou X64 a Arm64.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-BurstingEnabled

Umožňuje rozšíření nad rámec zřízeného cíle výkonu disku. Ve výchozím nastavení je shlukování zakázané. Nevztahuje se na disky Úrovně Ultra.

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CreateOption

Určuje, jestli tato rutina vytvoří na virtuálním počítači disk z image platformy nebo uživatele, vytvoří prázdný disk nebo připojí existující disk.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DataAccessAuthMode

Další požadavky na ověřování při exportu nebo nahrání na disk nebo snímek

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DiskAccessId

Získá nebo nastaví ID ARM prostředku DiskAccess pro použití privátních koncových bodů.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DiskEncryptionKey

Určuje objekt šifrovacího klíče disku na disku.

Typ:KeyVaultAndSecretReference
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DiskEncryptionSetId

Určuje ID prostředku sady šifrování disku, které se má použít k povolení šifrování neaktivních uložených dat.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DiskIOPSReadOnly

Celkový počet vstupně-výstupních operací za sekundu, které budou povoleny pro všechny virtuální počítače, které připojí sdílený disk jako jen pro čtení. Jedna operace se může přenášet mezi 4k a 256k bajty.

Typ:Int64
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DiskIOPSReadWrite

Počet vstupně-výstupních operací za sekundu povolených pro tento disk; lze nastavit pouze pro disky UltraSSD. Jedna operace se může přenášet mezi 4k a 256k bajty.

Typ:Int64
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DiskMBpsReadOnly

Celková propustnost (MB/s), která bude povolena pro všechny virtuální počítače, které připojí sdílený disk jako jen pro čtení. MBps znamená miliony bajtů za sekundu - MB zde používá zápis ISO, mocnin 10.

Typ:Int64
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DiskMBpsReadWrite

Šířka pásma povolená pro tento disk; lze nastavit pouze pro disky UltraSSD. MBps znamená miliony bajtů za sekundu - MB zde používá zápis ISO, mocnin 10.

Typ:Int64
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DiskSizeGB

Určuje velikost disku v GB.

Typ:Int32
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-EdgeZone

Nastaví název hraniční zóny. Pokud je tato možnost nastavená, dotaz bude směrován do zadaného hraničního pásma místo do hlavní oblasti.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-EncryptionSettingsEnabled

Povolte nastavení šifrování.

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-EncryptionType

Typ klíče, který se používá k šifrování dat disku. Dostupné hodnoty jsou: EncryptionAtRestWithPlatformKey, EncryptionAtRestWithCustomerKey.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-GalleryImageReference

Objekt GalleryImageReference. Vyžaduje se při vytváření z obrázku galerie. ID bude ID ARM verze sdílené image galley, ze které se má vytvořit disk. Logická jednotka je nutná, pokud je zdrojem kopie jeden z datových disků v imagi galerie; Pokud má hodnotu null, zkopíruje se disk s operačním systémem image.

Typ:ImageDiskReference
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-HyperVGeneration

Generace hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem. Povolené hodnoty jsou V1 a V2.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ImageReference

Určuje odkaz na image na disku. ID bude ID ARM identifikátoru PIR nebo image uživatele, ze které se má vytvořit disk. Logická jednotka je nutná, pokud je zdrojem kopie jeden z datových disků v imagi galerie; Pokud má hodnotu null, zkopíruje se disk s operačním systémem image.

Typ:ImageDiskReference
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-KeyEncryptionKey

Určuje šifrovací klíč klíče na disku.

Typ:KeyVaultAndKeyReference
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Location

Určuje umístění.

Typ:String
Position:3
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-LogicalSectorSize

Velikost logického sektoru v bajtech pro disky Úrovně Ultra

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-MaxSharesCount

Maximální počet virtuálních počítačů, které se můžou připojit k disku najednou. Hodnota větší než jedna označuje disk, který lze připojit na více virtuálních počítačů současně.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NetworkAccessPolicy

Zásady přístupu k síti definují zásady přístupu k síti. Mezi možné hodnoty patří: AllowAll, AllowPrivate, DenyAll.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-OptimizedForFrequentAttach

Nastavení této vlastnosti na true zlepšuje spolehlivost a výkon datových disků, které jsou často (více než 5krát denně) odpojením od jednoho virtuálního počítače a připojenými k jinému. Tato vlastnost by neměla být nastavená pro disky, které nejsou odpojené a připojené často, protože to způsobí, že disky nebudou v souladu s doménou selhání virtuálního počítače.

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-OsType

Určuje typ operačního systému.

Typ:Nullable<T>[OperatingSystemTypes]
Přípustné hodnoty:Windows, Linux
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PerformancePlus

Pokud chcete zvýšit výkon nasazeného disku, nastavte tento příznak na hodnotu true, abyste získali vyšší výkon, viz zde odpovídající cíl výkonu. Tento příznak lze nastavit pouze při vytváření disku a po povolení nelze tento příznak zakázat.

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PublicNetworkAccess

Zásady pro řízení exportu na disku

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PurchasePlan

Určuje plán nákupu disku.

Typ:PSPurchasePlan
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SkuName

Určuje název skladové položky účtu úložiště. Dostupné hodnoty jsou Standard_LRS, Premium_LRS, StandardSSD_LRS a UltraSSD_LRS, Premium_ZRS a StandardSSD_ZRS. UltraSSD_LRS lze použít pouze s hodnotou Empty pro parametr CreateOption.

Typ:String
Aliasy:AccountType
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SourceResourceId

Určuje ID zdrojového prostředku.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SourceUri

Určuje zdrojový identifikátor URI.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-StorageAccountId

Určuje ID účtu úložiště.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SupportsHibernation

Zákazníci můžou nastavit příznak SupportsHibernation na disku.

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Tag

Páry klíč-hodnota ve formě tabulky hash. Příklad: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Tier

Úroveň výkonu disku

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UploadSizeInBytes

Určuje velikost obsahu nahrávání, včetně zápatí virtuálního pevného disku při příkazu CreateOption upload. Tato hodnota by měla být mezi 20972032 (20 MiB + 512 bajtů pro zápatí virtuálního pevného disku) a 35183298347520 bajty (32 TiB + 512 bajtů pro zápatí virtuálního pevného disku).

Typ:Int64
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Zone

Určuje seznam logických zón disku.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

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

Výstupy

PSDisk