New-AzDiskConfig

  • Riferimento
Modulo:
Az.Compute

Crea un oggetto disco configurabile.

Sintassi

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

Descrizione

Il cmdlet New-AzDiskConfig crea un oggetto disco configurabile.

Esempio

Esempio 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;

Il primo comando crea un oggetto disco vuoto locale con dimensioni pari a 5 GB in Standard_LRS tipo di account di archiviazione. Imposta anche il tipo di sistema operativo Windows e abilita le impostazioni di crittografia. I secondi e i terzi comandi impostano le impostazioni della chiave di crittografia del disco e della chiave di crittografia della chiave per l'oggetto disco. L'ultimo comando accetta l'oggetto disco e crea un disco con il nome 'Disk01' nel gruppo di risorse 'ResourceGroup01'.

Esempio 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'

Il primo comando crea un oggetto disco locale per Upload. Il secondo comando accetta l'oggetto disco e crea un disco con nome 'Disk01' nel gruppo di risorse 'ResourceGroup01'. Il terzo comando ottiene l'URL della firma di accesso condiviso per il disco. Il quarto comando ottiene lo stato del disco. Se lo stato del disco è "ReadyToUpload", un utente può caricare un disco dall'archiviazione BLOB nell'URL di firma di accesso condiviso del disco usando AzCopy. Durante il caricamento, lo stato del disco viene modificato in 'ActiveUpload'. L'ultimo comando revoca l'accesso al disco per l'URL di firma di accesso condiviso.

Esempio 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

Creare un disco da una versione dell'immagine della raccolta condivisa. ID è l'ID della versione dell'immagine della raccolta condivisa. Lun è necessario solo se l'origine è un disco dati.

Esempio 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

Creare un disco con OptimizedForFrequentAttach come true, per migliorare l'affidabilità e le prestazioni dei dischi dati che saranno spesso (più di 5 volte al giorno) scollegati da una macchina virtuale e collegati a un altro.

Parametri

-AcceleratedNetwork

True se l'immagine da cui viene creato il disco del sistema operativo supporta la rete accelerata.

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

-Architecture

Architettura della CPU supportata da un disco del sistema operativo. I valori possibili sono "X64" e "Arm64".

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

-BurstingEnabled

Abilita il bursting oltre la destinazione delle prestazioni con provisioning del disco. Il bursting è disabilitato per impostazione predefinita. Non si applica ai dischi Ultra.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-CreateOption

Specifica se questo cmdlet crea un disco nella macchina virtuale da una piattaforma o un'immagine utente, crea un disco vuoto o collega un disco esistente.

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

-DataAccessAuthMode

Requisiti di autenticazione aggiuntivi per l'esportazione o il caricamento in un disco o uno snapshot.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

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

-DiskAccessId

Ottiene o imposta l'ID ARM della risorsa DiskAccess per l'uso di endpoint privati in .

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

-DiskEncryptionKey

Specifica l'oggetto chiave di crittografia del disco in un disco.

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

-DiskEncryptionSetId

Specifica l'ID risorsa del set di crittografia del disco da usare per abilitare la crittografia dei dati inattivi.

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

-DiskIOPSReadOnly

Numero totale di operazioni di I/O al secondo consentite in tutte le macchine virtuali che montano il disco condiviso come ReadOnly. Un'operazione può trasferire tra 4k e 256.000 byte.

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

-DiskIOPSReadWrite

Numero di operazioni di I/O al secondo consentite per questo disco; solo impostabile per i dischi UltraSSD. Un'operazione può trasferire tra 4k e 256.000 byte.

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

-DiskMBpsReadOnly

Velocità effettiva totale (MBps) che sarà consentita in tutte le macchine virtuali che montano il disco condiviso come ReadOnly. MBps significa milioni di byte al secondo - MB qui usa la notazione ISO, di poteri di 10.

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

-DiskMBpsReadWrite

Larghezza di banda consentita per questo disco; solo impostabile per i dischi UltraSSD. MBps significa milioni di byte al secondo - MB qui usa la notazione ISO, di poteri di 10.

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

-DiskSizeGB

Specifica le dimensioni del disco in GB.

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

-EdgeZone

Imposta il nome della zona perimetrale. Se impostata, la query verrà instradata alla zona perimetrale specificata anziché all'area principale.

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

-EncryptionSettingsEnabled

Abilitare le impostazioni di crittografia.

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

-EncryptionType

Tipo di chiave utilizzata per crittografare i dati del disco. I valori disponibili sono: 'EncryptionAtRestWithPlatformKey', 'EncryptionAtRestWithCustomerKey'

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

-GalleryImageReference

Oggetto GalleryImageReference. Obbligatorio se si crea da un'immagine della raccolta. L'ID sarà l'ID ARM della versione dell'immagine condivisa da cui creare un disco. È necessario un lun se l'origine della copia è uno dei dischi dati nell'immagine della raccolta; se null, il disco del sistema operativo dell'immagine verrà copiato.

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

-HyperVGeneration

Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo. I valori consentiti sono V1 e V2.

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

-ImageReference

Specifica il riferimento all'immagine in un disco. L'ID sarà l'ID ARM dell'immagine PIR o utente da cui creare un disco. È necessario un LUN se l'origine della copia è uno dei dischi dati nell'immagine della raccolta; se null, il disco del sistema operativo dell'immagine verrà copiato.

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

-KeyEncryptionKey

Specifica la chiave di crittografia della chiave in un disco.

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

-Location

Specifica una posizione.

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

-LogicalSectorSize

Dimensioni del settore logico in byte per i dischi Ultra.

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

-MaxSharesCount

Numero massimo di macchine virtuali che possono essere collegate al disco contemporaneamente. Il valore maggiore di uno indica un disco che può essere montato in più macchine virtuali contemporaneamente.

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

-NetworkAccessPolicy

I criteri di accesso alla rete definiscono i criteri di accesso alla rete. I valori possibili includono: 'AllowAll', 'AllowPrivate', 'DenyAll'

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

-OptimizedForFrequentAttach

L'impostazione di questa proprietà su true migliora l'affidabilità e le prestazioni dei dischi dati che sono spesso (più di 5 volte al giorno) scollegati da una macchina virtuale e collegati a un altro. Questa proprietà non deve essere impostata per i dischi non scollegati e collegati frequentemente perché i dischi non sono allineati al dominio di errore della macchina virtuale.

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

-OsType

Specifica il tipo di sistema operativo.

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

-PerformancePlus

Impostare questo flag su true per ottenere un aumento della destinazione delle prestazioni del disco distribuito, vedere qui nella rispettiva destinazione delle prestazioni. Questo flag può essere impostato solo in fase di creazione del disco e non può essere disabilitato dopo l'abilitazione.

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

-PublicNetworkAccess

Criteri per controllare l'esportazione sul disco.

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

-PurchasePlan

Specifica il piano di acquisto per il disco.

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

-SkuName

Specifica il nome sku dell'account di archiviazione. I valori disponibili sono Standard_LRS, Premium_LRS, StandardSSD_LRS e UltraSSD_LRS, Premium_ZRS e StandardSSD_ZRS. UltraSSD_LRS può essere usato solo con il valore Vuoto per il parametro CreateOption.

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

-SourceResourceId

Specifica l'ID risorsa di origine.

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

-SourceUri

Specifica l'URI di origine.

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

-StorageAccountId

Specifica l'ID dell'account di archiviazione.

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

-SupportsHibernation

I clienti possono impostare il flag SupportsHibernation sul disco.

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

-Tag

Coppie chiave-valore sotto forma di tabella hash. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}

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

-Tier

Livello di prestazioni del disco.

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

-UploadSizeInBytes

Specifica le dimensioni del contenuto del caricamento, incluso il piè di pagina del disco rigido virtuale quando CreateOption è Upload. Questo valore deve essere compreso tra 20972032 (20 MiB + 512 byte per il piè di pagina del disco rigido virtuale) e 35183298347520 byte (32 TiB + 512 byte per il piè di pagina del disco rigido virtuale).

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

-Zone

Specifica l'elenco di zone logiche per Disco.

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

Input

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

Output

PSDisk