New-AzureStorSimpleDeviceVolume
Cria um volume em um contêiner de volume especificado.
Observação
Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.
O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
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, em seguida, armazena-os 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. Esse 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, em seguida, 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 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. Esse 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 e, portanto, ele retorna um TaskStatusInfo depois de criar o volume.
Como o comando não especifica registros 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.
| Tipo: | List<T>[AccessControlRecord] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-DeviceName
Especifica o nome do dispositivo StorSimple no qual criar o volume.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EnableDefaultBackup
Especifica se o backup padrão deve ser habilitado para o volume.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EnableMonitoring
Especifica se o monitoramento do volume deve ser habilitado.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Online
Especifica se o volume deve ser criado online.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Profile
Especifica um perfil do Azure.
| Tipo: | AzureSMProfile |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VolumeAppType
Especifica se um volume principal ou de arquivamento deve ser criado. Os valores válidos são: PrimaryVolume e ArchiveVolume.
| Tipo: | AppType |
| Aliases: | AppType |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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 .
| Tipo: | DataContainer |
| Aliases: | Container |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-VolumeName
Especifica um nome para o novo volume.
| Tipo: | String |
| Aliases: | Name |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VolumeSizeInBytes
Especifica o tamanho do volume em bytes.
| Tipo: | Int64 |
| Aliases: | SizeInBytes |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WaitForComplete
Indica que esse cmdlet aguarda a conclusão da operação antes de retornar o controle ao console do Windows PowerShell.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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 retornará um objeto TaskStatusInfo , se você especificar o parâmetro WaitForComplete .