Expand-SCVirtualDiskDrive
Expande um disco rígido virtual conectado a um objeto de unidade de disco virtual.
Sintaxe
Expand-SCVirtualDiskDrive
[-VirtualDiskDrive] <VirtualDiskDrive>
-VirtualHardDiskSizeGB <Int32>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Description
O cmdlet Expand-SCVirtualDiskDrive expande um disco rígido virtual conectado a um objeto de unidade de disco virtual para aumentar a capacidade total do disco rígido virtual. Se o arquivo de disco virtual se conectar à cadeia SCSI de uma máquina virtual, você poderá redimensionar o disco virtual enquanto a máquina virtual estiver online.
Este cmdlet expande um arquivo .vhd ou .vhdx baseado no Windows anexado a um objeto de unidade de disco virtual em uma máquina virtual implantada em um host Hyper-V. Você também pode usar esse cmdlet para expandir um arquivo .vmdk baseado em VMware em uma máquina virtual implantada em um host ESX. Não é possível usar esse cmdlet para expandir um disco rígido virtual em uma máquina virtual implantada em um host Citrix XenServer.
Exemplos
Exemplo 1: Expandir um disco rígido virtual
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM $VM | Where-Object {$_.Bus -Eq 0 -And $_.Lun -Eq 0}
PS C:\> Expand-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive -VirtualHardDiskSizeGB 40
O primeiro comando obtém o objeto de máquina virtual chamado 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 localizado no primeiro controlador ($. Bus -Eq 0) e primeiro slot desse controlador ($. Lun -Eq 0) do VM01 e armazena esse objeto na variável $VirtDiskDrive.
O último comando expande o tamanho do disco rígido virtual conectado à unidade de disco virtual para 40 GB.
Parâmetros
-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 |
-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. Especifique esse parâmetro e o parâmetro OnBehalfOfUser para remover permissões de uma função de usuário que pertence a um em nome do usuário. Para obter um objeto de função de usuário, use o cmdlet Get-SCUserRole.
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 |
-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: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-VirtualHardDiskSizeGB
Especifica o tamanho, em gigabytes (GB), para o qual um disco rígido virtual em expansão dinâmica se expande.
Tipo: | Int32 |
Aliases: | Size |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Saídas
VirtualHardDisk
Este cmdlet retorna um objeto VirtualHardDisk.
Notas
- Este cmdlet requer um objeto de unidade de disco virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualDiskDrive.