Partager via

New-AzureStorSimpleDeviceVolume

  • Référence
Module:
Azure

Crée un volume dans un conteneur de volumes spécifié.

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

New-AzureStorSimpleDeviceVolume
   -DeviceName <String>
   -VolumeContainer <DataContainer>
   -VolumeName <String>
   -VolumeSizeInBytes <Int64>
   -AccessControlRecords <System.Collections.Generic.List`1[Microsoft.WindowsAzure.Management.StorSimple.Models.AccessControlRecord]>
   -VolumeAppType <AppType>
   -Online <Boolean>
   -EnableDefaultBackup <Boolean>
   -EnableMonitoring <Boolean>
   [-WaitForComplete]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande New-AzureStorSimpleDeviceVolume crée un volume dans un conteneur de volumes spécifié. Cette applet de commande associe chaque volume à un ou plusieurs enregistrements de contrôle d’accès. Pour obtenir des objets AccessControlRecord , utilisez l’applet de commande Get-AzureStorSimpleAccessControlRecord . Spécifiez un nom, une taille et un AppType pour le volume. Spécifiez également s’il faut créer le volume en ligne, s’il faut activer la sauvegarde par défaut et s’il faut activer la surveillance.

Exemples

Exemple 1 : Créer un volume

PS C:\>$AcrList = Get-AzureStorSimpleAccessControlRecord
PS C:\> Get-AzureStorSimpleDeviceVolumeContainer -DeviceName "Contoso63-AppVm" -VolumeContainerName "VolumeContainer07" | New-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" -Size 2000000000 -AccessControlRecords $AcrList -VolumeAppType PrimaryVolume -Online $True -EnableDefaultBackup $False -EnableMonitoring $False

VERBOSE: ClientRequestId: a29d1a84-1f81-4f20-9130-7adfe45e41fb_PS
VERBOSE: ClientRequestId: 8fa63df1-3f81-4029-a536-b536a70068ad_PS
VERBOSE: ClientRequestId: 964c5744-8bb1-4f70-beda-95ca4c7f3eb6_PS
VERBOSE: ClientRequestId: f09fff3a-54fa-4a0e-93db-b079260ed2dd_PS
VERBOSE: ClientRequestId: 59aa29e3-8044-411a-adae-b64a2681ffed_PS
VERBOSE: ClientRequestId: 0ffd0297-19be-40fe-a64e-6a2947d831b4_PS
c3b1ad53-7a51-49d7-ae83-94ff1ff3ab90
VERBOSE: The create task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
c3b1ad53-7a51-49d7-ae83-94ff1ff3ab90 for tracking the task's status
VERBOSE: Volume container with name: VolumeContainer07 is found.

La première commande obtient les enregistrements de contrôle d’accès dans la configuration du service StorSimple Manager à l’aide de l’applet de commande Get-AzureStorSimpleAccessControlRecord , puis les stocke dans la variable $AcrList.

La deuxième commande obtient le conteneur de volumes nommé VolumeContainer07 pour l’appareil nommé Contoso63-AppVm à l’aide de l’applet de commande Get-AzureStorSimpleDeviceVolumeContainer . La commande transmet ce conteneur à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. Cette applet de commande crée le volume. La commande spécifie le nom du volume, de la taille et des enregistrements de contrôle d’accès stockés dans $AcrList. Cette commande démarre le travail, puis retourne un objet TaskResponse . Pour afficher l’état du travail, utilisez l’applet de commande Get-AzureStorSimpleTask .

Exemple 2 : Créer un volume sans contrôle d’accès controlaccess

PS C:\>Get-AzureStorSimpleDeviceVolumeContainer -DeviceName "Contoso63-AppVm" -VolumeContainerName "VolumeContainer01" | New-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume22" -Size 2000000000 -AccessControlRecords @() -VolumeAppType PrimaryVolume -Online $True -EnableDefaultBackup $False -EnableMonitoring $False -WaitForComplete
VERBOSE: ClientRequestId: 3f359790-7e1f-48e7-acf8-ecabba850966_PS
VERBOSE: ClientRequestId: 2723ebcf-cd72-47bb-99b5-0c099d45641b_PS
VERBOSE: ClientRequestId: e605091f-dd63-42a7-bda2-24753cbc1f9a_PS
VERBOSE: ClientRequestId: b3fd08c3-67c5-4309-9591-15d92c360469_PS
VERBOSE: ClientRequestId: 15a024a3-b0c9-4f83-9c34-0ed8b95d024b_PS
VERBOSE: ClientRequestId: c13f92f9-aea1-40dd-af80-3affe273adbe_PS


TaskId       : ceef657e-390e-4f7a-aab7-669a29c29e7f
TaskResult   : Succeeded
TaskStatus   : Completed
ErrorCode    : 
ErrorMessage : 
TaskSteps    : {Microsoft.WindowsAzure.Management.StorSimple.Models.TaskStep}

VERBOSE: The task created for your create operation has completed successfully. 
VERBOSE: ClientRequestId: 1d79febf-f752-4255-af2d-230d40773bc6_PS
AccessType             : NoAccess
AcrIdList              : {}
AcrList                : {}
AppType                : PrimaryVolume
DataContainer          : Microsoft.WindowsAzure.Management.StorSimple.Models.DataContainer
DataContainerId        : 68b63d15-6aa5-4e69-9f9d-4a0bc607d6e9
InstanceId             : SS-VOL-d73b7eec-76fc-4310-b347-69b160de8cdd
InternalInstanceId     : 
IsBackupEnabled        : False
IsDefaultBackupEnabled : False
IsMonitoringEnabled    : False
Name                   : Volume22
Online                 : True
OperationInProgress    : None
SizeInBytes            : 2000000000
VSN                    : SS-VOL-d73b7eec-76fc-4310-b347-69b160de8cdd

VERBOSE: Volume container with name: VolumeContainer01 is found.

Cette commande obtient le conteneur de volumes nommé VolumeContainer01 pour l’appareil nommé Contoso63-AppVm à l’aide de l’applet de commande Get-AzureStorSimpleDeviceVolumeContainer . La commande transmet ce conteneur à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. Cette applet de commande crée le volume. La commande spécifie le nom du volume, la taille et une valeur vide pour les enregistrements de contrôle d’accès. Cette commande spécifie le paramètre WaitForComplete , de sorte qu’il retourne un TaskStatusInfo après avoir créé le volume.

Étant donné que la commande ne spécifie aucun enregistrement de contrôle d’accès, ce volume n’est pas accessible. Vous pouvez ajouter un accès, plus tard, à l’aide de l’applet de commande Set-AzureStorSimpleDeviceVolume .

Paramètres

-AccessControlRecords

Spécifie une liste d’enregistrements de contrôle d’accès à associer au volume.

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

-DeviceName

Spécifie le nom de l’appareil StorSimple sur lequel créer le volume.

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

-EnableDefaultBackup

Spécifie s’il faut activer la sauvegarde par défaut pour le volume.

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

-EnableMonitoring

Spécifie s’il faut activer la surveillance du volume.

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

-Online

Spécifie s’il faut créer le volume en ligne.

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

-Profile

Spécifie un profil Azure.

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

-VolumeAppType

Spécifie s’il faut créer un volume principal ou archive. Les valeurs valides sont : PrimaryVolume et ArchiveVolume.

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

-VolumeContainer

Spécifie le conteneur, en tant qu’objet DataContainer , dans lequel créer le volume. Pour obtenir un objet VirtualDisk , utilisez l’applet de commande Get-AzureStorSimpleDeviceVolumeContainer .

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

-VolumeName

Spécifie un nom pour le nouveau volume.

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

-VolumeSizeInBytes

Spécifie la taille du volume en octets.

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

-WaitForComplete

Indique que cette applet de commande attend la fin de l’opération avant de retourner le contrôle à la console Windows PowerShell.

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

Entrées

DataContainer, List\<AccessControlRecord\>

Cette applet de commande accepte un objet DataContainer et une liste d’objets AccessControlRecord pour le nouveau volume.

Sorties

TaskStatusInfo

Cette applet de commande renvoie un objet TaskStatusInfo , si vous spécifiez le paramètre WaitForComplete .