Partilhar 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 Virtual Machine Manager (VMM). Você pode usar esse cmdlet para alterar o tipo de de barramento (IDE ou SCSI) ou para 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 no VM01 e, em seguida, armazena o objeto no $VirtDiskDrive. Usando o símbolo @ e parênteses, certifique-se de que o comando armazene 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 do 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 de 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, em seguida, 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 armazenados no $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 pelo -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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CreateDiffDisk

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

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

-DisableStorageQoS

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

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

-IDE

Indica que 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IOPSMaximum

Especifica o IOPS máximo.

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

-JobGroup

Especifica um identificador para uma série de comandos que são executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.

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

-JobVariable

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

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

-LUN

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

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

-OnBehalfOfUser

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

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

-OnBehalfOfUserRole

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

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

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

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

-RunAsynchronously

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SharedStorage

Indica se a unidade de disco virtual usa armazenamento compartilhado.

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

-StorageClassification

Especifica um objeto de classificação de armazenamento.

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

-StorageQoSPolicy

Especifica uma política de QoS de armazenamento.

Tipo:StorageQoSPolicy
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VolumeType

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

  • Bota
  • Sistema
  • BootAndSystem
  • Nenhum
Tipo:VolumeType
Valores aceites:None, Boot, System, BootAndSystem
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

VirtualDiskDrive

Este cmdlet retorna um objeto VirtualDiskDrive.

Notas

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