Add-AzureDataDisk

Référence

Module:: Azure

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

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskLabel

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

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskName

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DiskSizeInGB

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

Type:	Int32
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-HostCaching

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

None
Lecture seule
Lecture/écriture

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Renseignez-vous
SilentlyContinue
Arrêter
Suspendre

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Spécifie une variable d’informations.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Aliases:	InputObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False