Compartir a través de

New-AzureStorSimpleDeviceVolume

  • Referencia
Módulo:
Azure

Crea un volumen en un contenedor de volúmenes especificado.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

El cmdlet New-AzureStorSimpleDeviceVolume crea un volumen en un contenedor de volúmenes especificado. Este cmdlet asocia cada volumen a uno o varios registros de control de acceso. Para obtener objetos AccessControlRecord , use el cmdlet Get-AzureStorSimpleAccessControlRecord . Especifique un nombre, tamaño y AppType para el volumen. Además, especifique si se va a crear el volumen en línea, si se va a habilitar la copia de seguridad predeterminada y si se va a habilitar la supervisión.

Ejemplos

Ejemplo 1: Creación de un volumen

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.

El primer comando obtiene los registros de control de acceso en la configuración del servicio StorSimple Manager mediante el cmdlet Get-AzureStorSimpleAccessControlRecord y, a continuación, los almacena en la variable $AcrList.

El segundo comando obtiene el contenedor de volúmenes denominado VolumeContainer07 para el dispositivo denominado Contoso63-AppVm mediante el cmdlet Get-AzureStorSimpleDeviceVolumeContainer . El comando pasa ese contenedor al cmdlet actual mediante el operador de canalización. Este cmdlet crea el volumen. El comando especifica el nombre del volumen, el tamaño y los registros de control de acceso almacenados en $AcrList. Este comando inicia el trabajo y, a continuación, devuelve un objeto TaskResponse . Para ver el estado del trabajo, use el cmdlet Get-AzureStorSimpleTask .

Ejemplo 2: Creación de un volumen sin control de accesoAcceso de control de acceso

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.

Este comando obtiene el contenedor de volúmenes denominado VolumeContainer01 para el dispositivo denominado Contoso63-AppVm mediante el cmdlet Get-AzureStorSimpleDeviceVolumeContainer . El comando pasa ese contenedor al cmdlet actual mediante el operador de canalización. Este cmdlet crea el volumen. El comando especifica el nombre del volumen, el tamaño y un valor vacío para los registros de control de acceso. Este comando especifica el parámetro WaitForComplete , por lo que devuelve un TaskStatusInfo después de crear el volumen.

Dado que el comando no especifica registros de control de acceso, no se puede tener acceso a este volumen. Puede agregar acceso, más adelante, mediante el cmdlet Set-AzureStorSimpleDeviceVolume .

Parámetros

-AccessControlRecords

Especifica una lista de registros de control de acceso que se van a asociar al volumen.

Tipo:List<T>[AccessControlRecord]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DeviceName

Especifica el nombre del dispositivo StorSimple en el que se va a crear el volumen.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableDefaultBackup

Especifica si se va a habilitar la copia de seguridad predeterminada para el volumen.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableMonitoring

Especifica si se va a habilitar la supervisión del volumen.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Online

Especifica si se va a crear el volumen en línea.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

Especifica un perfil de Azure.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VolumeAppType

Especifica si se va a crear un volumen principal o de archivo. Los valores válidos son: PrimaryVolume y ArchiveVolume.

Tipo:AppType
Alias:AppType
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VolumeContainer

Especifica el contenedor, como un objeto DataContainer , en el que se va a crear el volumen. Para obtener un objeto VirtualDisk , use el cmdlet Get-AzureStorSimpleDeviceVolumeContainer .

Tipo:DataContainer
Alias:Container
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VolumeName

Especifica un nombre para el nuevo volumen.

Tipo:String
Alias:Name
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VolumeSizeInBytes

Especifica el tamaño del volumen en bytes.

Tipo:Int64
Alias:SizeInBytes
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WaitForComplete

Indica que este cmdlet espera a que se complete la operación antes de devolver el control a la consola de Windows PowerShell.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

DataContainer, List\<AccessControlRecord\>

Este cmdlet acepta un objeto DataContainer y una lista de objetos AccessControlRecord para el nuevo volumen.

Salidas

TaskStatusInfo

Este cmdlet devuelve un objeto TaskStatusInfo , si especifica el parámetro WaitForComplete .