New-AzDiskConfig
Crée un objet disque configurable.
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
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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DataAccessAuthMode
Exigences d’authentification supplémentaires lors de l’exportation ou du chargement sur un disque ou instantané.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskEncryptionKey
Spécifie l’objet de clé de chiffrement de disque sur un disque.
Type: | KeyVaultAndSecretReference |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskMBpsReadOnly
Débit total (Mo ps) qui sera autorisé sur toutes les machines virtuelles qui montent le disque partagé comme ReadOnly. Mo ps signifie des millions d’octets par seconde - Mo ici utilise la notation ISO, de puissances de 10.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskMBpsReadWrite
Bande passante autorisée pour ce disque ; uniquement paramétrable pour les disques UltraSSD. Mo ps signifie des millions d’octets par seconde - Mo ici utilise la notation ISO, de puissances de 10.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskSizeGB
Spécifie la taille du disque en Go.
Type: | Int32 |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncryptionSettingsEnabled
Activez les paramètres de chiffrement.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncryptionType
Type de clé utilisé pour chiffrer les données du disque. Les valeurs disponibles sont : « EncryptionAtRestWithPlatformKey », « EncryptionAtRestWithCustomerKey »
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-KeyEncryptionKey
Spécifie la clé de chiffrement de clé sur un disque.
Type: | KeyVaultAndKeyReference |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
Spécifie un emplacement.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LogicalSectorSize
Taille du secteur logique en octets pour les disques Ultra.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OsType
Spécifie le type de système d’exploitation.
Type: | Nullable<T>[OperatingSystemTypes] |
Accepted values: | Windows, Linux |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublicNetworkAccess
Stratégie de contrôle de l’exportation sur le disque.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PurchasePlan
Spécifie le plan d’achat pour le disque.
Type: | PSPurchasePlan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Aliases: | AccountType |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceResourceId
Spécifie l’ID de ressource source.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceUri
Spécifie l’URI source.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountId
Spécifie l’ID du compte de stockage.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SupportsHibernation
Les clients peuvent définir l’indicateur SupportsHibernation sur le disque.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tier
Niveau de performances du disque.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Zone
Spécifie la liste de zones logiques pour le disque.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entrées
Nullable<T>[[Microsoft.Azure.Management.Compute.Models.OperatingSystemTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
String[]
Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]