Partilhar via

Set-SCVirtualDiskDrive

Módulo:
VirtualMachineManager Module

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

Sintaxe

BusChanges (Predefiniçã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 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.

Propriedades dos parâmetros

Tipo:Byte
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-CreateDiffDisk

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

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DisableStorageQoS

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IOPSMaximum

Especifica o IOPS máximo.

Propriedades dos parâmetros

Tipo:UInt64
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

IOPSMaximum
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-JobVariable

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 dos parâmetros

Tipo:Byte
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-OnBehalfOfUser

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:UserRole
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RunAsynchronously

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SharedStorage

Indica se a unidade de disco virtual usa armazenamento compartilhado.

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-StorageClassification

Especifica um objeto de classificação de armazenamento.

Propriedades dos parâmetros

Tipo:StorageClassification
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-StorageQoSPolicy

Especifica uma política de QoS de armazenamento.

Propriedades dos parâmetros

Tipo:StorageQoSPolicy
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

StorageQoSPolicy
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 dos parâmetros

Tipo:VirtualDiskDrive
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

Propriedades dos parâmetros

Tipo:VolumeType
Default value:None
Valores aceites:None, Boot, System, BootAndSystem
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

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 .