Compartilhar via

Remove-SCVirtualDiskDrive

  • Referência
Módulo:
VirtualMachineManager

Remove unidades de disco virtual de uma máquina virtual ou de um modelo de máquina virtual.

Syntax

Remove-SCVirtualDiskDrive
      [-VirtualDiskDrive] <VirtualDiskDrive>
      [-SkipDeleteVHD]
      [-JobGroup <Guid>]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

O cmdlet Remove-SCVirtualDiskDrive remove objetos de unidade de disco virtual de uma máquina virtual ou de um modelo de máquina virtual em um ambiente do VMM (Virtual Machine Manager).

Exemplos

Exemplo 1: remover uma unidade de disco virtual de uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine | Where-Object { $_.VMHost.Name -Eq "VMHost01.Contoso.com" -And $_.Name -Eq "VM01" }
PS C:\> $VirtDiskDrive = @(Get-SCVirtualDiskDrive -VM $VM)
PS C:\> If($VirtDiskDrive.Count -Gt 1){Remove-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive[1]}

O primeiro comando obtém o objeto de máquina virtual chamado VM01 implantado em VMHost01 usando o cmdlet Get-SCVirtualMachine . O comando armazena esse objeto na variável $VM.

O segundo comando obtém todos os objetos de unidade de disco virtual na VM01 e armazena os objetos recuperados em $VirtDiskDrive. Usar o símbolo @ e parênteses garante que o comando armazene os resultados em uma matriz, mesmo que o comando retorne um único objeto ou um valor $Null.

O último comando retorna o número de unidades de disco virtual associadas à máquina virtual e, se houver mais de uma, o comando removerá a segunda unidade de disco virtual, designada pelo [1], da máquina virtual.

Exemplo 2: remover todos os discos de passagem anexados a uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine | Where-Object {$_.Name -Eq "VM02"}
PS C:\> $VirtDiskDrives = @(Get-SCVirtualDiskDrive -VM $VM | Where-Object {$_.IsVHD -Eq $False})
PS C:\> If($VirtDiskDrives.Count -Gt 0){ForEach($VirtDiskDrive in $VirtDiskDrives){Remove-SCVirtualDiskDrive -Force -VirtualDiskDrive $VirtDiskDrive}}

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 anexados à VM02 que não são discos rígidos virtuais. O comando obtém apenas objetos que representam discos de passagem. O comando armazena os objetos de disco de passagem na matriz de objetos $VDDs.

O último comando usa uma instrução If para determinar se existe pelo menos uma unidade de disco virtual de passagem. Se o resultado for um ou mais, o comando usará a instrução ForEach para remover cada unidade de disco virtual da matriz de objetos. Para obter mais informações, digite Get-Help about_If e Get-Help about_Foreach.

O último comando especifica o parâmetro Force . Portanto, o comando remove cada unidade de disco virtual de sua máquina virtual, mesmo que outros objetos do VMM dependam dessa unidade de disco virtual.

Exemplo 3: remover unidades de disco virtual por nome

PS C:\> $VM = @(Get-SCVirtualMachine | Where-Object {$_.Name -Match "WebSrvLOB"})
PS C:\> ForEach-Object ($VM in $VMs){$VirtDiskDrives = Get-SCVirtualDiskDrive -VM $VM 
PS C:\> ForEach-Object ($VirtDiskDrive in $VirtDiskDrives){If($VirtDiskDrive.Name -Match "LOBData"){Remove-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive}}}

O primeiro comando obtém todos os objetos de máquina virtual cujo nome corresponde à cadeia de caracteres WebSrvLOB e armazena esses objetos na matriz $VM.

Os dois comandos seguintes usam o cmdlet ForEach-Object para iterar por meio das máquinas virtuais armazenadas em $VM para obter todos os objetos de unidade de disco virtual de cada máquina virtual. O segundo comando armazena os objetos de unidade de disco virtual na matriz de objetos $VirtDiskDrives.

O terceiro comando usa um segundo loop ForEach para selecionar todos os objetos de unidade de disco virtual cujo nome contém a cadeia de caracteres LOBData da matriz $VirtDiskDrives e passa esses objetos para o cmdlet atual. Esse cmdlet remove os objetos do VMM.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-Force

Força a operação a ser concluída.

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

-JobGroup

Especifica um identificador para uma série de comandos executados como um conjunto pouco 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

-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

-SkipDeleteVHD

Indica que esse cmdlet não faz o arquivo VHD enquanto remove a unidade de disco virtual.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Observações

  • Requer um objeto de unidade de disco virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualDiskDrive .