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.

Tipo:	Nullable<T>[Boolean]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Architecture

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	Nullable<T>[Boolean]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-DataAccessAuthMode

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DiskAccessId

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-DiskEncryptionKey

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

Tipo:	KeyVaultAndSecretReference
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-DiskEncryptionSetId

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	Int64
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	Int64
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	Int64
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	Int64
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-DiskSizeGB

Specifica le dimensioni del disco in GB.

Tipo:	Int32
Posizione:	2
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-EdgeZone

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-EncryptionSettingsEnabled

Abilitare le impostazioni di crittografia.

Tipo:	Nullable<T>[Boolean]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-EncryptionType

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	ImageDiskReference
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-HyperVGeneration

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	ImageDiskReference
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-KeyEncryptionKey

Specifica la chiave di crittografia della chiave in un disco.

Tipo:	KeyVaultAndKeyReference
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Location

Specifica una posizione.

Tipo:	String
Posizione:	3
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-LogicalSectorSize

Dimensioni del settore logico in byte per i dischi Ultra.

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-NetworkAccessPolicy

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	Nullable<T>[Boolean]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-OsType

Specifica il tipo di sistema operativo.

Tipo:	Nullable<T>[OperatingSystemTypes]
Valori accettati:	Windows, Linux
Posizione:	1
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	Nullable<T>[Boolean]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-PublicNetworkAccess

Criteri per controllare l'esportazione sul disco.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-PurchasePlan

Specifica il piano di acquisto per il disco.

Tipo:	PSPurchasePlan
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	String
Alias:	AccountType
Posizione:	0
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-SourceResourceId

Specifica l'ID risorsa di origine.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-SourceUri

Specifica l'URI di origine.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-StorageAccountId

Specifica l'ID dell'account di archiviazione.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-SupportsHibernation

I clienti possono impostare il flag SupportsHibernation sul disco.

Tipo:	Nullable<T>[Boolean]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Tag

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

Tipo:	Hashtable
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Tier

Livello di prestazioni del disco.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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).

Tipo:	Int64
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Zone

Specifica l'elenco di zone logiche per Disco.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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

Condividi tramite