Compartilhar via

Set-SCVirtualDiskDrive

Módulo:
VirtualMachineManager Module

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

Sintaxe

BusChanges (Padrão) 

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

StorageQoSPolicy 

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

IOPSMaximum 

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

DisableStorageQoS 

Set-SCVirtualDiskDrive
    -VirtualDiskDrive <VirtualDiskDrive>
    [-Bus <Byte>]
    [-LUN <Byte>]
    [-SCSI]
    [-IDE]
    [-VolumeType <VolumeType>]
    [-StorageClassification <StorageClassification>]
    [-SharedStorage <Boolean>]
    [-CreateDiffDisk <Boolean>]
    [-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 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 da unidade de disco virtual na VM01 e, em seguida, armazena o objeto em $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 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 conectar uma unidade de disco virtual.

Propriedades do parâmetro

Tipo:Byte
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CreateDiffDisk

Indica se o cmdlet cria um disco diferencial.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DisableStorageQoS

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

DisableStorageQoS
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IOPSMaximum

Especifica o máximo de IOPS.

Propriedades do parâmetro

Tipo:UInt64
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

IOPSMaximum
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-JobGroup

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

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-JobVariable

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Byte
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OnBehalfOfUser

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:UserRole
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RunAsynchronously

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SharedStorage

Indica se a unidade de disco virtual usa armazenamento compartilhado.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StorageClassification

Especifica um objeto de classificação de armazenamento.

Propriedades do parâmetro

Tipo:StorageClassification
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StorageQoSPolicy

Especifica uma política de QoS de armazenamento.

Propriedades do parâmetro

Tipo:StorageQoSPolicy
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

StorageQoSPolicy
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:VirtualDiskDrive
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VolumeType

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

  • Inicialização
  • Sistema
  • BootAndSystem
  • Nenhum

Propriedades do parâmetro

Tipo:VolumeType
Valor padrão:None
Valores aceitos:None, Boot, System, BootAndSystem
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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 .