Partager via

New-AzDiskConfig

  • Référence
Module:
Az.Compute

Crée un objet disque configurable.

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

L’applet de commande New-AzDiskConfig crée un objet de disque configurable.

Exemples

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

La première commande crée un objet disque vide local de taille 5 Go dans Standard_LRS type de compte de stockage. Il définit également le type de système d’exploitation Windows et active les paramètres de chiffrement. Les deuxième et troisième commandes définissent les paramètres de clé de chiffrement de disque et de clé de chiffrement de clé pour l’objet disque. La dernière commande prend l’objet disque et crée un disque nommé « Disk01 » dans le groupe de ressources « ResourceGroup01 ».

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

La première commande crée un objet disque local pour Upload. La deuxième commande prend l’objet disque et crée un disque nommé « Disk01 » dans le groupe de ressources « ResourceGroup01 ». La troisième commande obtient l’URL SAP du disque. La quatrième commande obtient l’état du disque. Si l’état du disque est « ReadyToUpload », un utilisateur peut charger un disque à partir du stockage Blob vers l’URL SAS du disque à l’aide d’AzCopy. Lors du chargement, l’état du disque est remplacé par « ActiveUpload ». La dernière commande révoque l’accès au disque pour l’URL SAP.

Exemple 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

Créez un disque à partir d’une version d’image de galerie partagée. L’ID est l’ID de la version de l’image de la galerie partagée. Lun est nécessaire uniquement si la source est un disque de données.

Exemple 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

Créez un disque avec OptimizedForFrequentAttach comme vrai, afin d’améliorer la fiabilité et les performances des disques de données qui seront fréquemment (plus de 5 fois par jour) détachés d’une machine virtuelle et attachées à une autre.

Paramètres

-AcceleratedNetwork

True si l’image à partir de laquelle le disque du système d’exploitation est créé prend en charge la mise en réseau accélérée.

Type:Nullable<T>[Boolean]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Architecture

Architecture du processeur prise en charge par un disque de système d’exploitation. Les valeurs possibles sont « X64 » et « Arm64 ».

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-BurstingEnabled

Active le bursting au-delà de la cible de performances provisionnée du disque. Le bursting est désactivé par défaut. Ne s’applique pas aux disques Ultra.

Type:Nullable<T>[Boolean]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CreateOption

Spécifie si cette applet de commande crée un disque dans la machine virtuelle à partir d’une plateforme ou d’une image utilisateur, crée un disque vide ou attache un disque existant.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DataAccessAuthMode

Exigences d’authentification supplémentaires lors de l’exportation ou du chargement sur un disque ou un instantané.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DiskAccessId

Obtient ou définit l’ID ARM de la ressource DiskAccess pour l’utilisation de points de terminaison privés.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DiskEncryptionKey

Spécifie l’objet de clé de chiffrement de disque sur un disque.

Type:KeyVaultAndSecretReference
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DiskEncryptionSetId

Spécifie l’ID de ressource du jeu de chiffrement de disque à utiliser pour activer le chiffrement au repos.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DiskIOPSReadOnly

Nombre total d’E/S par seconde qui seront autorisées sur toutes les machines virtuelles qui montent le disque partagé comme ReadOnly. Une opération peut transférer entre 4 000 et 256 000 octets.

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DiskIOPSReadWrite

Nombre d’E/S par seconde autorisées pour ce disque ; uniquement paramétrable pour les disques UltraSSD. Une opération peut transférer entre 4 000 et 256 000 octets.

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DiskMBpsReadOnly

Débit total (MBits/s) autorisé sur toutes les machines virtuelles qui montent le disque partagé en lecture Seule. Les Mbits/s signifient des millions d’octets par seconde : Mo utilise ici la notation ISO, de puissances de 10.

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DiskMBpsReadWrite

Bande passante autorisée pour ce disque ; uniquement paramétrable pour les disques UltraSSD. Les Mbits/s signifient des millions d’octets par seconde : Mo utilise ici la notation ISO, de puissances de 10.

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DiskSizeGB

Spécifie la taille du disque en Go.

Type:Int32
Position:2
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-EdgeZone

Définit le nom de la zone de périphérie. Si elle est définie, la requête est routée vers la zone de périphérie spécifiée au lieu de la région principale.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-EncryptionSettingsEnabled

Activez les paramètres de chiffrement.

Type:Nullable<T>[Boolean]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-EncryptionType

Type de clé utilisé pour chiffrer les données du disque. Les valeurs disponibles sont : « EncryptionAtRestWithPlatformKey », « EncryptionAtRestWithCustomerKey »

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-GalleryImageReference

Objet GalleryImageReference. Obligatoire si vous créez à partir d’une image de galerie. L’ID sera l’ID ARM de la version d’image de galère partagée à partir de laquelle créer un disque. Un lun est nécessaire si la source de la copie est l’un des disques de données de l’image de la galerie ; si la valeur est Null, le disque du système d’exploitation de l’image est copié.

Type:ImageDiskReference
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-HyperVGeneration

Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation. Les valeurs autorisées sont V1 et V2.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ImageReference

Spécifie la référence d’image sur un disque. L’ID sera l’ID ARM de l’image PIR ou utilisateur à partir de laquelle créer un disque. Un LUN est nécessaire si la source de la copie est l’un des disques de données de l’image de la galerie ; si la valeur est Null, le disque du système d’exploitation de l’image est copié.

Type:ImageDiskReference
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-KeyEncryptionKey

Spécifie la clé de chiffrement de clé sur un disque.

Type:KeyVaultAndKeyReference
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Location

Spécifie un emplacement.

Type:String
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LogicalSectorSize

Taille du secteur logique en octets pour les disques Ultra.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-MaxSharesCount

Nombre maximal de machines virtuelles pouvant être attachées au disque en même temps. La valeur supérieure à une indique un disque pouvant être monté sur plusieurs machines virtuelles en même temps.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-NetworkAccessPolicy

La stratégie d’accès réseau définit la stratégie d’accès réseau. Les valeurs possibles sont les suivantes : « AllowAll », « AllowPrivate », « DenyAll »

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-OptimizedForFrequentAttach

Définir cette propriété sur true améliore la fiabilité et les performances des disques de données qui sont fréquemment (plus de 5 fois par jour) en détachés d’une machine virtuelle et attachés à un autre. Cette propriété ne doit pas être définie pour les disques qui ne sont pas détachés et attachés fréquemment, car les disques ne doivent pas s’aligner sur le domaine d’erreur de la machine virtuelle.

Type:Nullable<T>[Boolean]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-OsType

Spécifie le type de système d’exploitation.

Type:Nullable<T>[OperatingSystemTypes]
Valeurs acceptées:Windows, Linux
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PerformancePlus

Définissez cet indicateur sur true pour obtenir une amélioration de la cible de performances du disque déployé, voir ici sur la cible de performances respective. Cet indicateur ne peut être défini que sur l’heure de création du disque et ne peut pas être désactivé après l’activation.

Type:Nullable<T>[Boolean]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PublicNetworkAccess

Stratégie de contrôle de l’exportation sur le disque.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PurchasePlan

Spécifie le plan d’achat pour le disque.

Type:PSPurchasePlan
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SkuName

Spécifie le nom de la référence SKU du compte de stockage. Les valeurs disponibles sont Standard_LRS, Premium_LRS, StandardSSD_LRS et UltraSSD_LRS, Premium_ZRS et StandardSSD_ZRS. UltraSSD_LRS ne peut être utilisé qu’avec une valeur vide pour le paramètre CreateOption.

Type:String
Alias:AccountType
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SourceResourceId

Spécifie l’ID de ressource source.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SourceUri

Spécifie l’URI source.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-StorageAccountId

Spécifie l’ID du compte de stockage.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SupportsHibernation

Les clients peuvent définir l’indicateur SupportsHibernation sur le disque.

Type:Nullable<T>[Boolean]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Tag

Paires clé-valeur sous la forme d’une table de hachage. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"}

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Tier

Niveau de performances du disque.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-UploadSizeInBytes

Spécifie la taille du contenu du chargement, y compris le pied de page du disque dur virtuel lors du chargement de CreateOption. Cette valeur doit être comprise entre 20972032 (20 Mio + 512 octets pour le pied de page VHD) et 35183298347520 octets (32 Tio + 512 octets pour le pied de page VHD).

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Zone

Spécifie la liste de zones logiques pour le disque.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

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

Sorties

PSDisk