Set-AzureStorSimpleDeviceVolume

Atualiza as propriedades de um volume existente.

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

Set-AzureStorSimpleDeviceVolume
   -DeviceName <String>
   -VolumeName <String>
   [-Online <Boolean>]
   [-VolumeSizeInBytes <Int64>]
   [-VolumeAppType <AppType>]
   [-AccessControlRecords <System.Collections.Generic.List`1[Microsoft.WindowsAzure.Management.StorSimple.Models.AccessControlRecord]>]
   [-WaitForComplete]
   [-NewName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureStorSimpleDeviceVolume
   -DeviceName <String>
   -Volume <VirtualDisk>
   [-Online <Boolean>]
   [-VolumeSizeInBytes <Int64>]
   [-VolumeAppType <AppType>]
   [-AccessControlRecords <System.Collections.Generic.List`1[Microsoft.WindowsAzure.Management.StorSimple.Models.AccessControlRecord]>]
   [-WaitForComplete]
   [-NewName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureStorSimpleDeviceVolume atualiza as propriedades de um volume existente. Este cmdlet associa um volume a um ou mais registros de controle de acesso. Para obter objetos AccessControlRecord , use o cmdlet Get-AzureStorSimpleAccessControlRecord . Atualize o tamanho ou o tipo do volume. Além disso, atualize se deseja criar o volume online.

Exemplos

Exemplo 1: Atualizar o valor online de um volume

PS C:\>Set-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" -Online $False
VERBOSE: ClientRequestId: f2869570-ea47-4be7-801e-9c0f22f2600d_PS
VERBOSE: ClientRequestId: c70bb86a-51d3-4390-be17-4d0847641dc3_PS
VERBOSE: ClientRequestId: d20cb5b2-6b3c-4e06-af99-cada28c5e50a_PS
VERBOSE: ClientRequestId: ab6d533e-b55b-4cfb-9c58-9153295e0547_PS
de7000f1-29c7-4102-a375-b52432f9e67e
VERBOSE: The update task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
de7000f1-29c7-4102-a375-b52432f9e67e for tracking the task's status

Este comando atualiza o volume chamado Volume18 para ter um valor online de $False. Este comando inicia a tarefa e, em seguida, retorna um objeto TaskResponse . Para ver o status da tarefa, use o cmdlet Get-AzureStorSimpleTask .

Exemplo 2: Modificar o valor e o tipo online

PS C:\>Set-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" -Online $True -VolumeAppType ArchiveVolume 
VERBOSE: ClientRequestId: af42b02a-645e-4801-a2d7-4197511c68cf_PS
VERBOSE: ClientRequestId: 7cb4f3b4-548e-42dc-a38c-0df0911c5206_PS
VERBOSE: ClientRequestId: 7cc706ad-a58f-4939-8e78-cabae8379a51_PS
VERBOSE: ClientRequestId: 6bed21d5-12fc-4a12-a89c-120bdb5636b1_PS
aa977225-af78-4c93-b754-72704afc928f
VERBOSE: The update task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
aa977225-af78-4c93-b754-72704afc928f for tracking the task's status

Este comando atualiza o volume chamado Volume18. Ele modifica o tipo e altera o valor do parâmetro Online para $True.

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:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DeviceName

Especifica o nome do dispositivo StorSimple no qual o volume será atualizado.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationAction

Especifica como esse cmdlet responde a um evento de informação.

Os valores aceitáveis para este parâmetro são:

  • Continuar
  • Ignorar
  • Informe-se
  • SilenciosamenteContinue
  • Parar
  • Suspender
Tipo:ActionPreference
Aliases:infa
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NewName

Especifica um novo nome para o dispositivo StorSimple.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Online

Especifica se o volume está online.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
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

-Volume

Especifica o nome do volume a ser atualizado.

Tipo:VirtualDisk
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VolumeAppType

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

Tipo:AppType
Aliases:AppType
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VolumeName

Especifica o nome do volume a ser atualizado.

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 atualizado, em bytes, para o volume.

Tipo:Int64
Aliases:SizeInBytes
Position:Named
Default value:None
Necessário:False
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

List\<AccessControlRecord\>

Este cmdlet aceita uma lista de objetos AccessControlRecord para associar a um volume.

Saídas

TaskStatusInfo

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