Dela via

Remove-SCVirtualHardDisk

  • Referens
Modul:
VirtualMachineManager

Tar bort ett virtuellt hårddiskobjekt från en virtuell dator eller mall, eller från VMM-biblioteket.

Syntax

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

Description

Cmdleten Remove-SCVirtualHardDisk tar bort ett virtuellt hårddiskobjekt från en virtuell dator eller mall eller från VMM-biblioteket (Virtual Machine Manager). Remove-VirtualHardDisk också tar bort motsvarande virtuella hårddiskfil (en Windows-baserad .vhd-fil, en Citrix XenServer-baserad .vhd-fil eller en VMware-baserad .vmdk-fil) från biblioteksservern.

Om den virtuella hårddisken är ansluten till en virtuell diskenhet på en virtuell dator eller mall (och om du inte använder parametern Force) visar VMM containern som innehåller den virtuella hårddisken och uppmanar dig att bekräfta att du vill ta bort den virtuella hårddisken:

  • Om du svarar Ja tar VMM bort associationen mellan den virtuella hårddisken och containern som den är ansluten till och tar sedan bort det virtuella hårddiskobjektet från VMM.

  • Om du svarar Nej avbryts åtgärden.

Den här cmdleten returnerar objektet när det lyckas (med egenskapen MarkedForDeletion inställd på True) eller returnerar ett felmeddelande vid fel.

Exempel

Exempel 1: Ta bort ett virtuellt hårddiskobjekt från biblioteket

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

Det första kommandot hämtar det virtuella hårddiskobjektet med namnet VHD01.vhd som lagras på LibraryServer01 och lagrar det returnerade objektet i variabeln $VHD.

Det andra kommandot tar bort det virtuella hårddiskobjektet som lagras i $VHD från biblioteket och tar bort motsvarande fil från filsystemet på biblioteksservern.

Exempel 2: Ta bort en virtuell hårddisk från en virtuell dator

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

Det första kommandot ansluter till VMMServer01.

Det andra kommandot hämtar det virtuella datorobjektet VM01, hämtar alla virtuella hårddiskar på VM01 vars namn innehåller strängen "DataDisk" och lagrar sedan dessa virtuella hårddiskobjekt i en matris med namnet $VHD.

Det tredje kommandot tar bort varje virtuellt hårddiskobjekt som lagras i den $VHD matrisen från den virtuella datorn och tar bort varje motsvarande fil från filsystemet på biblioteksservern.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JobGroup

Anger en identifierare för en serie kommandon som ska köras som en uppsättning precis innan det slutliga kommandot som innehåller samma jobbgruppsidentifierare körs.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JobVariable

Anger att jobbstatus spåras och lagras i variabeln med namnet av den här parametern.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PROTipID

Anger ID för tipset prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen omedelbart återgår till kommandogränssnittet.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VirtualHardDisk

Anger ett virtuellt hårddiskobjekt.

Typ:VirtualHardDisk
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Kommentarer

  • Kräver ett virtuellt VMM-hårddiskobjekt som kan hämtas med hjälp av cmdleten Get-SCVirtualHardDisk.