Move-SCVirtualHardDisk

Move um arquivo de disco rígido virtual de um local para outro no mesmo host ou, quando usado com Move-SCVirtualMachine, para um local em um host diferente.

Sintaxe

MoveVHDOnSCSI

Move-SCVirtualHardDisk
    -Bus <Byte>
    -LUN <Byte>
    -JobGroup <Guid>
    -Path <String>
    [-VMMServer <ServerConnection>]
    [-SCSI]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

MoveVHDOnIDE

Move-SCVirtualHardDisk
    -Bus <Byte>
    -LUN <Byte>
    -JobGroup <Guid>
    -Path <String>
    [-VMMServer <ServerConnection>]
    [-IDE]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

SetVM

Move-SCVirtualHardDisk
    [-VirtualHardDisk] <StandaloneVirtualHardDisk>
    -Path <String>
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

O cmdlet Move-SCVirtualHardDisk move um arquivo de disco rígido virtual baseado no Windows (um arquivo .vhd) ou um arquivo de disco rígido virtual baseado em VMware (um arquivo .vmdk) de um local para outro no mesmo host. Você também pode usar Move-SCVirtualHardDisk com o cmdlet Move-SCVirtualMachine para mover um arquivo de disco rígido virtual para um local em um host diferente.

Você pode usar esse cmdlet para executar as seguintes tarefas:

  • Mova um disco rígido virtual em uma máquina virtual VMware em execução sem interrupção do serviço.

  • Mova um disco rígido virtual em uma máquina virtual Windows Server 2008 R2, Windows Server 2012 ou Windows Server 2016 em execução com interrupção mínima do serviço. Nesse caso, use Move-SCVirtualHardDisk com Move-SCVirtualMachine.

  • Mova um disco rígido virtual em uma máquina virtual em qualquer tipo de host se a máquina virtual estiver em um estado interrompido ou em um estado salvo. Nesse caso, use Move-SCVirtualHardDisk com Set-SCVirtualMachine. Esta opção é suportada se uma das seguintes condições for verdadeira:

-- A máquina virtual está em um host que usa a tecnologia de Hyper-V Windows Server 2008 R2, Windows Server 2012 ou Windows Server 2016 ou em um host VMware ESX, e a máquina virtual está em um estado salvo ou em um estado interrompido.

-- A máquina virtual está em qualquer outro host suportado e está em um estado interrompido.

Exemplos de uso:

  • Se um host tiver várias unidades de disco físico e a máquina virtual tiver dois discos rígidos virtuais (um disco pode conter o sistema operacional e o outro disco pode conter dados), você pode usar esse cmdlet para mover um dos discos rígidos virtuais para um disco rígido físico diferente, a fim de melhorar o desempenho de ambos os discos rígidos virtuais.

  • Se a máquina virtual tiver um disco rígido virtual em expansão dinâmica e você descobrir que o disco rígido virtual se expandiu até um ponto em que usa a maior parte do espaço em seu disco rígido físico atual no host, poderá usar esse cmdlet para mover o disco rígido virtual expandido para um disco rígido físico maior, se houver um disponível no host.

Exemplos

Exemplo 1: Mover um arquivo de disco rígido virtual de um local para outro no mesmo host

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $VHD = $VM.VirtualHardDisks[0]
PS C:\> Move-SCVirtualHardDisk -VirtualHardDisk $VHD -Path "C:\VHDs"

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.

O segundo comando armazena o primeiro objeto de disco rígido virtual no VM01 na variável $VHD.

O último comando move o disco rígido virtual armazenado em $VHD para a pasta existente "C:\VHDs".

Parâmetros

-Bus

Especifica o barramento IDE ao qual anexar uma unidade de disco virtual ou unidade de DVD 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

MoveVHDOnSCSI
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
MoveVHDOnIDE
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IDE

Especifica IDE como o tipo de barramento ao qual anexar um objeto de unidade de disco virtual ou um objeto de unidade de DVD virtual configurado em uma máquina virtual ou em um modelo.

Exemplo de formato: -IDE -Bus 0 -LUN 1

Propriedades dos parâmetros

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

Conjuntos de parâmetros

MoveVHDOnIDE
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 serã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

MoveVHDOnSCSI
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
MoveVHDOnIDE
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-JobVariable

Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada 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

-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 DVD virtual em um barramento IDE ou para um objeto de unidade de disco virtual em um barramento SCSI.

  • Exemplo de formato: -IDE -Bus 1 -LUN 0
  • Exemplo de formato: -SCSI -Bus 0 -LUN 1

Propriedades dos parâmetros

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

Conjuntos de parâmetros

MoveVHDOnSCSI
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
MoveVHDOnIDE
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Path

Especifica o caminho de destino para a operação.

Exemplos de formatos:

  • Caminho local: -Path "F:\"
  • Caminho UNC: -Path "\\Library\Templates"
  • Caminho do GUID do volume: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • Caminho VMware ESX: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Caminho do Citrix XenServer: -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"

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

Exemplo de formato: -SCSI -Bus 0 -LUN 0

Propriedades dos parâmetros

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

Conjuntos de parâmetros

MoveVHDOnSCSI
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VirtualHardDisk

Especifica um objeto de disco rígido virtual.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

SetVM
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMMServer

Especifica um objeto de servidor VMM.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

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

VirtualHardDisk

Este cmdlet retorna um objeto VirtualHardDisk .