Partager via

Add-AzureDataDisk

  • Référence
Module:
Azure

Ajoute un disque de données à une machine virtuelle.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Add-AzureDataDisk
   [-CreateNew]
   [-DiskSizeInGB] <Int32>
   [-DiskLabel] <String>
   [-LUN] <Int32>
   [-MediaLocation <String>]
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-Import]
   [-DiskName] <String>
   [-LUN] <Int32>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-ImportFrom]
   [-DiskLabel] <String>
   [-LUN] <Int32>
   -MediaLocation <String>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande Add-AzureDataDisk ajoute un disque de données nouveau ou existant à un objet de machine virtuelle Azure. Utilisez le paramètre CreateNew pour créer un disque de données dont la taille et l’étiquette sont spécifiées. Utilisez le paramètre Import pour attacher un disque existant à partir du référentiel d’images. Utilisez le paramètre ImportFrom pour attacher un disque existant à partir d’un objet blob dans un compte de stockage. Vous pouvez spécifier le mode de cache hôte du disque de données attaché.

Exemples

Exemple 1 : Importer un disque de données à partir du référentiel

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Add-AzureDataDisk -Import -DiskName "Disk68" -LUN 0 | Update-AzureVM

Cette commande obtient un objet de machine virtuelle pour la machine virtuelle nommée VirtualMachine07 dans le service cloud ContosoService à l’aide de l’applet de commande Get-AzureVM . La commande la transmet à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. Cette commande attache un disque de données existant du référentiel à la machine virtuelle. Le disque de données a un numéro d’unité logique de 0. La commande met à jour la machine virtuelle pour refléter vos modifications à l’aide de l’applet de commande Update-AzureVM .

Exemple 2 : Ajouter un nouveau disque de données

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine08" | Add-AzureDataDisk -CreateNew -DiskSizeInGB 128 -DiskLabel "main" -LUN 0 | Update-AzureVM

Cette commande obtient un objet de machine virtuelle pour la machine virtuelle nommée VirtualMachine08. La commande la transmet à l’applet de commande actuelle. Cette commande attache un nouveau disque de données nommé MyNewDisk.vhd. L’applet de commande crée le disque dans le conteneur vhds dans le compte de stockage par défaut de l’abonnement actuel. La commande met à jour la machine virtuelle pour refléter vos modifications.

Exemple 3 : Ajouter un disque de données à partir d’un emplacement spécifié

PS C:\> Get-AzureVM "ContosoService" -Name "Database" | Add-AzureDataDisk -ImportFrom -MediaLocation "https://contosostorage.blob.core.windows.net/container07/Disk14.vhd" -DiskLabel "main" -LUN 0 | Update-AzureVM

Cette commande obtient un objet de machine virtuelle pour la machine virtuelle nommée Base de données. La commande la transmet à l’applet de commande actuelle. Cette commande attache un disque de données existant nommé Disk14.vhd à partir de l’emplacement spécifié. La commande met à jour la machine virtuelle pour refléter vos modifications.

Paramètres

-CreateNew

Indique que cette applet de commande crée un disque de données.

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

-DiskLabel

Spécifie l’étiquette de disque d’un nouveau disque de données.

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

-DiskName

Spécifie le nom d’un disque de données dans le référentiel de disques.

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

-DiskSizeInGB

Spécifie la taille du disque logique, en gigaoctets, pour un nouveau disque de données.

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

-HostCaching

Spécifie les paramètres de mise en cache au niveau de l’hôte du disque. Les valeurs autorisées sont :

  • Aucune
  • Lecture seule
  • Lecture/écriture
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Import

Indique que cette applet de commande importe un disque de données existant à partir du référentiel d’images.

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

-ImportFrom

Indique que cette applet de commande importe un disque de données existant à partir d’un objet blob dans un compte de stockage.

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

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Arrêter
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

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

-LUN

Spécifie le numéro d’unité logique (LUN) du lecteur de données dans la machine virtuelle. Les valeurs valides sont : 0 à 15. Chaque disque de données doit avoir un numéro d’unité logique unique.

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

-MediaLocation

Spécifie l’emplacement de l’objet blob dans un compte de stockage Azure où cette applet de commande stocke le disque de données. Si vous ne spécifiez pas d’emplacement, l’applet de commande stocke le disque de données dans le conteneur vhds dans le compte de stockage par défaut de l’abonnement actuel. Si un conteneur vhds n’existe pas, l’applet de commande crée un conteneur de disques durs virtuels.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-VM

Spécifie l’objet de machine virtuelle auquel cette applet de commande attache un disque de données. Pour obtenir un objet de machine virtuelle, utilisez l’applet de commande Get-AzureVM .

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