Condividi tramite

Remove-SCVirtualHardDisk

  • Riferimento
Modulo:
VirtualMachineManager

Rimuove un oggetto disco rigido virtuale da una macchina virtuale o da un modello o dalla libreria VMM.

Sintassi

Remove-SCVirtualHardDisk
      [-VirtualHardDisk] <VirtualHardDisk>
      [-JobGroup <Guid>]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Remove-SCVirtualHardDisk rimuove un oggetto disco rigido virtuale da una macchina virtuale o da un modello o dalla libreria Virtual Machine Manager (VMM). Remove-VirtualHardDisk elimina anche il file del disco rigido virtuale corrispondente (un file VHD basato su Windows, un file VHD basato su Citrix XenServer o un file vmdk basato su VMware) dal server di libreria.

Se il disco rigido virtuale è collegato a un'unità disco virtuale in una macchina virtuale o un modello (e se non si usa il parametro Force ), VMM elenca il contenitore che contiene il disco rigido virtuale e chiede di confermare di voler rimuovere il disco rigido virtuale:

  • Se si risponde Sì, VMM rimuove l'associazione tra il disco rigido virtuale e il contenitore a cui è collegato e quindi elimina l'oggetto disco rigido virtuale da VMM.

  • Se si risponde No, l'operazione viene annullata.

Questo cmdlet restituisce l'oggetto al completamento (con la proprietà MarkedForDeletion impostata su True) o restituisce un messaggio di errore in caso di errore.

Esempio

Esempio 1: Rimuovere un oggetto disco rigido virtuale dalla libreria

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCVirtualHardDisk -VirtualHardDisk $VHD

Il primo comando ottiene l'oggetto disco rigido virtuale denominato VHD01.vhd archiviato in LibraryServer01 e archivia l'oggetto restituito nella variabile $VHD.

Il secondo comando rimuove l'oggetto disco rigido virtuale archiviato in $VHD dalla libreria ed elimina il file corrispondente dal file system nel server di libreria.

Esempio 2: Rimuovere un disco rigido virtuale da una macchina virtuale

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }
PS C:\> $VHD | Remove-SCVirtualHardDisk

Il primo comando si connette a VMMServer01.

Il secondo comando ottiene l'oggetto macchina virtuale denominato VM01, ottiene tutti i dischi rigidi virtuali in VM01 il cui nome include la stringa "DataDisk" e quindi archivia questi oggetti disco rigido virtuale in una matrice denominata $VHD.

Il terzo comando rimuove ogni oggetto disco rigido virtuale archiviato nell'array di $VHD dalla macchina virtuale ed elimina ogni file corrispondente dal file system nel server di libreria.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

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

-JobGroup

Specifica un identificatore per una serie di comandi che verranno eseguiti come un insieme prima dell'esecuzione dell'ultimo comando che include lo stesso identificatore di gruppo di processi.

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

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

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

-PROTipID

Specifica l'ID della descrizione per le prestazioni e l'ottimizzazione delle risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti pro.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.

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

-VirtualHardDisk

Specifica un oggetto disco rigido virtuale.

Type:VirtualHardDisk
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Note

  • Richiede un oggetto disco rigido virtuale VMM, che può essere recuperato usando il cmdlet Get-SCVirtualHardDisk .