New-AzureStorSimpleDeviceVolume

  • Referência
Módulo:
Azure

Cria um volume em um contêiner de volume especificado.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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

O cmdlet New-AzureStorSimpleDeviceVolume cria um volume em um contêiner de volume especificado. Esse cmdlet associa cada volume a um ou mais registros de controle de acesso. Para obter objetos AccessControlRecord, use o cmdlet Get-AzureStorSimpleAccessControlRecord. Especifique um nome, tamanho e AppType para o volume. Além disso, especifique se deseja criar o volume online, se deseja habilitar o backup padrão e se deseja habilitar o monitoramento.

Exemplos

Exemplo 1: Criar um 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.

O primeiro comando obtém os registros de controle de acesso na configuração do serviço StorSimple Manager usando o cmdlet Get-AzureStorSimpleAccessControlRecord e os armazena na variável $AcrList.

O segundo comando obtém o contêiner de volume chamado VolumeContainer07 para o dispositivo chamado Contoso63-AppVm usando o cmdlet Get-AzureStorSimpleDeviceVolumeContainer . O comando passa esse contêiner para o cmdlet atual usando o operador de pipeline. Este cmdlet cria o volume. O comando especifica o nome do volume, o tamanho e os registros de controle de acesso armazenados no $AcrList. Esse comando inicia o trabalho e retorna um objeto TaskResponse . Para ver o status do trabalho, use o cmdlet Get-AzureStorSimpleTask .

Exemplo 2: Criar um volume sem controle de acessoregistros de controle de acessocontrole de acesso

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.

Esse comando obtém o contêiner de volume chamado VolumeContainer01 para o dispositivo chamado Contoso63-AppVm usando o cmdlet Get-AzureStorSimpleDeviceVolumeContainer . O comando passa esse contêiner para o cmdlet atual usando o operador de pipeline. Este cmdlet cria o volume. O comando especifica o nome do volume, o tamanho e um valor vazio para registros de controle de acesso. Esse comando especifica o parâmetro WaitForComplete, portanto, ele retorna um TaskStatusInfo depois de criar o volume.

Como o comando não especifica nenhum registro de controle de acesso, esse volume não pode ser acessado. Você pode adicionar acesso, posteriormente, usando o cmdlet Set-AzureStorSimpleDeviceVolume .

Parâmetros

-AccessControlRecords

Especifica uma lista de registros de controle de acesso a serem associados ao volume.

Type:List<T>[AccessControlRecord]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DeviceName

Especifica o nome do dispositivo StorSimple no qual criar o volume.

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

-EnableDefaultBackup

Especifica se o backup padrão deve ser habilitado para o volume.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-EnableMonitoring

Especifica se o monitoramento do volume deve ser habilitado.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Online

Especifica se o volume deve ser criado online.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Especifica um perfil do Azure.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VolumeAppType

Especifica se um volume primário ou de arquivamento deve ser criado. Os valores válidos são: PrimaryVolume e ArchiveVolume.

Type:AppType
Aliases:AppType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VolumeContainer

Especifica o contêiner, como um objeto DataContainer , no qual criar o volume. Para obter um objeto VirtualDisk , use o cmdlet Get-AzureStorSimpleDeviceVolumeContainer .

Type:DataContainer
Aliases:Container
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VolumeName

Especifica um nome para o novo volume.

Type:String
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VolumeSizeInBytes

Especifica o tamanho do volume em bytes.

Type:Int64
Aliases:SizeInBytes
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WaitForComplete

Indica que esse cmdlet aguarda a conclusão da operação antes de retornar o controle ao console do Windows PowerShell.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

DataContainer, List\<AccessControlRecord\>

Esse cmdlet aceita um objeto DataContainer e uma lista de objetos AccessControlRecord para o novo volume.

Saídas

TaskStatusInfo

Esse cmdlet retorna um objeto TaskStatusInfo , se você especificar o parâmetro WaitForComplete .