Compartilhar via

Set-SCVirtualDiskDrive

  • Referência
Módulo:
VirtualMachineManager

Modifica as configurações de uma unidade de disco virtual.

Sintaxe

Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   -StorageQoSPolicy <StorageQoSPolicy>
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   -IOPSMaximum <UInt64>
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-DisableStorageQoS]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVirtualDiskDrive modifica as configurações de um objeto de unidade de disco virtual em uma máquina virtual ou em um modelo de máquina virtual em um ambiente do VMM (Virtual Machine Manager). Você pode usar esse cmdlet para alterar o tipo de do Barramento (IDE ou SCSI) ou alterar as configurações de Barramento e LUN para conectar uma unidade de disco virtual a um local diferente no barramento.

Exemplos

Exemplo 1: alterar as configurações de barramento IDE e LUN para uma unidade de disco virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $VirtDiskDrive = @(Get-SCVirtualDiskDrive -VM $VM)
PS C:\> If($VirtDiskDrive.Count -Eq 1 -And $VirtDiskDrive[0].Bus -Eq 0 -And $VirtDiskDrive[0].Lun -Eq 1){Set-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive[0] -Bus 0 -LUN 0}

O primeiro comando obtém o objeto de máquina virtual VM01 usando o cmdlet Get-SCVirtualMachine . O comando armazena esse objeto na variável $VM.

O segundo comando obtém o objeto de unidade de disco virtual na VM01 e armazena o objeto em $VirtDiskDrive. Usando o símbolo @ e parênteses, verifique se o comando armazena os resultados em uma matriz, mesmo que o comando retorne um único objeto ou um valor $Null.

O último comando define o valor do Barramento como 0 e define o valor LUN como 0 para a unidade de disco virtual na VM01, se a máquina virtual tiver apenas uma unidade de disco virtual e estiver localizada no segundo slot do primeiro canal IDE.

Exemplo 2: alterar o tipo de barramento para uma unidade de disco virtual de SCSI para IDE

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM $VM
PS C:\> Set-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive[1] -IDE -Bus 0 -LUN 1

O primeiro comando obtém o objeto de máquina virtual chamado VM02 e armazena esse objeto na variável $VM.

O segundo comando obtém todos os objetos de unidade de disco virtual configurados para a máquina virtual armazenada em $VM e armazena esses objetos de unidade de disco virtual na matriz de objetos $VirtDiskDrive. Este exemplo pressupõe que a unidade de disco virtual esteja em um barramento SCSI.

O último comando define o tipo de Barramento como IDE. O comando conecta a segunda unidade de disco virtual, especificada por $VirtDiskDrive[1], ao Canal Primário (1) e ao slot 2, especificados por -Bus 0 e LUN 1.

Parâmetros

-Bus

Especifica o barramento IDE ao qual anexar uma unidade de disco virtual ou o barramento SCSI ao qual anexar uma unidade de disco virtual.

Tipo:Byte
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CreateDiffDisk

Indica se o cmdlet cria um disco de diferenciação.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableStorageQoS

Indica que esse cmdlet desabilita os padrões de QoS (Qualidade de Serviço) de armazenamento.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IDE

Indica que o IDE é o tipo de barramento ao qual anexar um objeto de unidade de disco virtual configurado em uma máquina virtual ou em um modelo.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IOPSMaximum

Especifica o IOPS máximo.

Tipo:UInt64
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobGroup

Especifica um identificador para uma série de comandos que são executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho é executado.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

Especifica uma variável na qual o progresso do trabalho é acompanhado e armazenado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LUN

Especifica o LUN (número de unidade lógica) para um objeto de unidade de disco virtual ou para um objeto de unidade de disco virtual em um barramento SCSI.

Tipo:Byte
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SCSI

Especifica SCSI como o tipo de barramento ao qual anexar um objeto de unidade de disco virtual configurado em uma máquina virtual ou em um modelo.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SharedStorage

Indica se a unidade de disco virtual usa armazenamento compartilhado.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StorageClassification

Especifica um objeto de classificação de armazenamento.

Tipo:StorageClassification
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StorageQoSPolicy

Especifica uma política de QoS de armazenamento.

Tipo:StorageQoSPolicy
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VirtualDiskDrive

Especifica um objeto de unidade de disco virtual. Você pode anexar um disco rígido virtual ou um disco de passagem a um objeto de unidade de disco virtual.

Tipo:VirtualDiskDrive
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VolumeType

Especifica o tipo de volume de um disco rígido virtual. Os valores aceitáveis para este parâmetro são:

  • Bota
  • Sistema
  • BootAndSystem
  • Nenhum
Tipo:VolumeType
Valores aceitos:None, Boot, System, BootAndSystem
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

VirtualDiskDrive

Esse cmdlet retorna um objeto VirtualDiskDrive.

Observações

  • Esse cmdlet requer um objeto de unidade de disco virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualDiskDrive.