New-AzDiskConfig

  • Reference
Modul:
Az.Compute

Vytvoří konfigurovatelný objekt disku.

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

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.

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

-Architecture

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-DataAccessAuthMode

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

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

-DefaultProfile

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

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

-DiskAccessId

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

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

-DiskEncryptionKey

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

Type:KeyVaultAndSecretReference
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-DiskSizeGB

Určuje velikost disku v GB.

Type:Int32
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-EncryptionSettingsEnabled

Povolte nastavení šifrování.

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

-EncryptionType

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:ImageDiskReference
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-KeyEncryptionKey

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

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

-Location

Určuje umístění.

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

-LogicalSectorSize

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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ě.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-OsType

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

Type:Nullable<T>[OperatingSystemTypes]
Accepted values:Windows, Linux
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-PublicNetworkAccess

Zásady pro řízení exportu na disku

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

-PurchasePlan

Určuje plán nákupu disku.

Type:PSPurchasePlan
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-SourceResourceId

Určuje ID zdrojového prostředku.

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

-SourceUri

Určuje zdrojový identifikátor URI.

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

-StorageAccountId

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

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

-SupportsHibernation

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

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

-Tag

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

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

-Tier

Úroveň výkonu disku

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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).

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

-WhatIf

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

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

-Zone

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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