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 contenente il disco rigido virtuale e chiede di confermare che si vuole 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 in caso di esito positivo (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 $VHD dalla macchina virtuale ed elimina ogni file corrispondente dal file system nel server di libreria.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobGroup

Specifica un identificatore per una serie di comandi che verranno eseguiti come set subito prima dell'esecuzione del comando finale che include lo stesso identificatore del gruppo di processi.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobVariable

Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PROTipID

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

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VirtualHardDisk

Specifica un oggetto disco rigido virtuale.

Tipo:VirtualHardDisk
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Note

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