New-AzDiskConfig

Syntaxe

Default (Par défaut)

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>]
    [-SecurityMetadataUri <String>]
    [-SecurityDataUri <String>]
    [-SupportedSecurityOption <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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;

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'

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

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

Exemple 5

$accountType = <Account Type>
$sourceUri = <Source URI of the blob>
$storageAccountId = <Storage Account ID>
$diskConfig = New-AzDiskConfig -AccountType $accountType -CreateOption Import -SourceUri $sourceUri -StorageAccountId $storageAccountId -SupportedSecurityOption 'TrustedLaunchSupported'
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskConfig

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.

Propriétés du paramètre

Jeux de paramètres

-Architecture

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

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-DataAccessAuthMode

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

Propriétés du paramètre

Jeux de paramètres

-DefaultProfile

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

Propriétés du paramètre

Jeux de paramètres

-DiskAccessId

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

Propriétés du paramètre

Jeux de paramètres

-DiskEncryptionKey

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

Propriétés du paramètre

Jeux de paramètres

-DiskEncryptionSetId

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

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-DiskSizeGB

Spécifie la taille du disque en Go.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-EncryptionSettingsEnabled

Activez les paramètres de chiffrement.

Propriétés du paramètre

Jeux de paramètres

-EncryptionType

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

Propriétés du paramètre

Jeux de paramètres

-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é.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-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é.

Propriétés du paramètre

Jeux de paramètres

-KeyEncryptionKey

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

Propriétés du paramètre

Jeux de paramètres

-Location

Spécifie un emplacement.

Propriétés du paramètre

Jeux de paramètres

-LogicalSectorSize

Taille du secteur logique en octets pour les disques Ultra.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-OsType

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

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-PublicNetworkAccess

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

Propriétés du paramètre

Jeux de paramètres

-PurchasePlan

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

Propriétés du paramètre

Jeux de paramètres

-SecurityDataUri

Si createOption est ImportSecure, il s’agit de l’URI d’un objet blob à importer dans l’état invité de la machine virtuelle.

Propriétés du paramètre

Jeux de paramètres

-SecurityMetadataUri

Si createOption a la valeur ImportSecure, il s’agit de l’URI d’un objet blob à importer dans les métadonnées de la machine virtuelle pour la machine virtuelle confidentielle.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-SourceResourceId

Spécifie l’ID de ressource source.

Propriétés du paramètre

Jeux de paramètres

-SourceUri

Spécifie l’URI source.

Propriétés du paramètre

Jeux de paramètres

-StorageAccountId

Spécifie l’ID du compte de stockage.

Propriétés du paramètre

Jeux de paramètres

-SupportedSecurityOption

Fait référence à la fonctionnalité de sécurité du disque prise en charge pour créer un lancement approuvé ou une machine virtuelle confidentielle. Les valeurs possibles sont les suivantes : « TrustedLaunchSupported », « TrustedLaunchAndConfidentialVMSupported »

Propriétés du paramètre

Jeux de paramètres

-SupportsHibernation

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

Propriétés du paramètre

Jeux de paramètres

-Tag

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

Propriétés du paramètre

Jeux de paramètres

-Tier

Niveau de performances du disque.

Propriétés du paramètre

Jeux de paramètres

-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).

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Jeux de paramètres

-Zone

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

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

String

Nullable<T>

Int32

String

Hashtable

ImageDiskReference

Nullable<T>

KeyVaultAndSecretReference

KeyVaultAndKeyReference

Sorties

PSDisk