Sdílet prostřednictvím

Remove-SCVirtualHardDisk

  • Reference
Modul:
VirtualMachineManager

Odebere objekt virtuálního pevného disku z virtuálního počítače nebo šablony nebo z knihovny VMM.

Syntax

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

Description

Rutina Remove-SCVirtualHardDisk odebere objekt virtuálního pevného disku z virtuálního počítače nebo šablony nebo z knihovny nástroje Virtual Machine Manager (VMM). Remove-VirtualHardDisk také odstraní odpovídající soubor virtuálního pevného disku (soubor .vhd založený na Windows, soubor .vhd založený na Citrix XenServeru nebo soubor VMware založené na .vmdk) ze serveru knihovny.

Pokud je virtuální pevný disk připojený k virtuální diskové jednotce na virtuálním počítači nebo šabloně (a pokud parametr Vynucení nepoužíváte), nástroj VMM zobrazí seznam kontejneru obsahujícího virtuální pevný disk a vyzve vás, abyste potvrdili, že chcete virtuální pevný disk odebrat:

  • Pokud odpovíte ano, nástroj VMM odebere přidružení mezi virtuálním pevným diskem a kontejnerem, ke kterému je připojený, a odstraní objekt virtuálního pevného disku z nástroje VMM.

  • Pokud odpovíte ne, operace se zruší.

Tato rutina vrátí objekt po úspěchu (s vlastností OznačenoForDeletion nastavenou na hodnotu True) nebo vrátí chybovou zprávu při selhání.

Příklady

Příklad 1: Odebrání objektu virtuálního pevného disku z knihovny

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

První příkaz získá objekt virtuálního pevného disku s názvem VHD01.vhd uložený na LibraryServer01 a uloží vrácený objekt do proměnné $VHD.

Druhý příkaz odebere objekt virtuálního pevného disku uložený v $VHD z knihovny a odstraní odpovídající soubor ze systému souborů na serveru knihovny.

Příklad 2: Odebrání virtuálního pevného disku z virtuálního počítače

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

První příkaz se připojí k VMMServer01.

Druhý příkaz získá objekt virtuálního počítače s názvem VM01, získá všechny virtuální pevné disky na virtuálním počítači VM01, jehož název obsahuje řetězec DataDisk a pak uloží tyto objekty virtuálního pevného disku do pole s názvem $VHD.

Třetí příkaz odebere každý objekt virtuálního pevného disku uložený v poli $VHD z virtuálního počítače a odstraní každý odpovídající soubor ze systému souborů na serveru knihovny.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Force

Vynutí spuštění příkazu bez nutnosti požádat o potvrzení uživatele.

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

-JobGroup

Určuje identifikátor řady příkazů, které se budou spouštět jako sada těsně před posledním příkazem, který obsahuje stejný identifikátor skupiny úloh.

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

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

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

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (tip PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

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

-RunAsynchronously

Označuje, že úloha se spouští asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

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

-VirtualHardDisk

Určuje objekt virtuálního pevného disku.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Poznámky

  • Vyžaduje objekt virtuálního pevného disku VMM, který lze načíst pomocí rutiny Get-SCVirtualHardDisk .