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.

Syntaxe

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 se systémem Windows, soubor .vhd založený na systému Citrix XenServer nebo soubor VMware .vmdk) ze serveru knihovny.

Pokud je virtuální pevný disk připojený k virtuální jednotce na virtuálním počítači nebo šabloně (a pokud nepoužíváte parametr Force), nástroj VMM zobrazí seznam kontejneru, který obsahuje virtuální pevný disk, a vyzve vás k potvrzení, ž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 pak 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í MarkedForDeletion 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 vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobGroup

Určuje identifikátor pro řadu příkazů, které se spustí jako sada těsně před posledním příkazem, který obsahuje stejné spuštění identifikátoru skupiny úloh.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VirtualHardDisk

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

Typ:VirtualHardDisk
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Poznámky

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