Set-SCVirtualDiskDrive

Módulo:

VirtualMachineManager

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

Syntax

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 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 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 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.

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CreateDiffDisk

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableStorageQoS

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IOPSMaximum

Especifica o IOPS máximo.

Type:	UInt64
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JobGroup

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

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JobVariable

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OnBehalfOfUser

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	UserRole
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PROTipID

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

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsynchronously

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SharedStorage

Indica se a unidade de disco virtual usa armazenamento compartilhado.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageClassification

Especifica um objeto de classificação de armazenamento.

Type:	StorageClassification
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageQoSPolicy

Especifica uma política de QoS de armazenamento.

Type:	StorageQoSPolicy
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	VirtualDiskDrive
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VolumeType

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

• Inicialização
• Sistema
• BootAndSystem
• Nenhum

Type:	VolumeType
Accepted values:	None, Boot, System, BootAndSystem
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Links Relacionados

• Compress-SCVirtualDiskDrive
• Convert-SCVirtualDiskDrive
• Expand-SCVirtualDiskDrive
• Get-SCVirtualDiskDrive
• Get-SCVirtualMachine
• New-SCVirtualDiskDrive
• Remove-SCVirtualDiskDrive
• Test-SCVirtualDiskDrive