New-AzureStorSimpleDeviceVolume
Cria um volume em um contêiner de volume especificado.
Nota
Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo PowerShell recomendado 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. Este 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 o monitoramento deve ser habilitado.
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. Este 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 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.Este 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. Este comando especifica o parâmetro WaitForComplete e, portanto, 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.
| Tipo: | List<T>[AccessControlRecord] |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-DeviceName
Especifica o nome do dispositivo StorSimple no qual criar o volume.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-EnableDefaultBackup
Especifica se o backup padrão deve ser habilitado para o volume.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-EnableMonitoring
Especifica se o monitoramento do volume deve ser habilitado.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Online
Especifica se o volume online deve ser criado.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Profile
Especifica um perfil do Azure.
| Tipo: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-VolumeAppType
Especifica se um volume primário ou de arquivo morto deve ser criado. Os valores válidos são: PrimaryVolume e ArchiveVolume.
| Tipo: | AppType |
| Aliases: | AppType |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | 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 |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-VolumeName
Especifica um nome para o novo volume.
| Tipo: | String |
| Aliases: | Name |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-VolumeSizeInBytes
Especifica o tamanho do volume em bytes.
| Tipo: | Int64 |
| Aliases: | SizeInBytes |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | 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 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
Entradas
DataContainer, List\<AccessControlRecord\>
Este 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 .