Freigeben über

Remove-SCVirtualDVDDrive

  • Referenz
Modul:
VirtualMachineManager

Entfernt ein virtuelles DVD-Laufwerkobjekt aus VMM.

Syntax

Remove-SCVirtualDVDDrive
      [-VirtualDVDDrive] <VirtualDVDDrive>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCVirtualDVDDrive
      -SourceBus <Byte>
      -SourceLUN <Byte>
      -JobGroup <Guid>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-SCVirtualDVDDrive entfernt ein oder mehrere virtuelle DVD-Laufwerkobjekte aus einem Hardwareprofil, einem virtuellen Computer oder einer virtuellen Computervorlage, die in einer VMM-Umgebung (Virtual Machine Manager) verwendet wird. Das Cmdlet löscht auch alle .iso Datei, die das virtuelle DVD-Laufwerk aus dem Dateisystem auf dem Bibliotheksserver verwendet.

Dieses Cmdlet gibt das Objekt nach Erfolg (mit der Eigenschaft "MarkedForDeletion" auf "True" festgelegt) zurück oder gibt bei Einem Fehler eine Fehlermeldung zurück.

Beispiele

Beispiel 1: Entfernen eines bestimmten virtuellen DVD-Laufwerks von einem virtuellen Computer

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Remove-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive

Der erste Befehl ruft das Objekt des virtuellen Computers mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl ruft das virtuelle DVD-Laufwerkobjekt auf dem ersten Steckplatz des sekundären Kanals (angegeben durch -Bus 1 und -LUN 0) auf dem IDE-Bus auf VM01 ab und speichert dann das virtuelle DVD-Laufwerkobjekt in der variablen $DVDDrive.

Der letzte Befehl entfernt das virtuelle DVD-Laufwerkobjekt, das in $DVDDrive von VM01 gespeichert ist, und löscht alle .iso Datei, die dieses virtuelle DVD-Laufwerk vom Dateisystem auf dem Bibliotheksserver verwendet.

Beispiel 2: Entfernen des dritten virtuellen DVD-Laufwerks von einem virtuellen Computer

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM
PS C:\> $DVDDrive[2] | Remove-SCVirtualDVDDrive

Der erste Befehl ruft das Objekt des virtuellen Computers namens VM02 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl ruft alle virtuellen DVD-Laufwerkobjekte ab, die mit VM02 verbunden sind, und speichert jedes virtuelle DVD-Laufwerkobjekt im $DVDDrive-Objektarray. In diesem Beispiel wird davon ausgegangen, dass VM02 über drei virtuelle DVD-Laufwerke verfügt und daher drei Elemente enthält (Zählung 0 bis 2).

Der letzte Befehl übergibt das dritte virtuelle DVD-Laufwerk (Objekt [2]), das in $DVDDrive gespeichert ist, an das Cmdlet Remove-SCVirtualDVDDrive, das dieses virtuelle DVD-Laufwerkobjekt aus VM02 entfernt und alle .iso Datei, die von diesem virtuellen DVD-Laufwerk verwendet wird, aus dem Dateisystem auf dem Bibliotheksserver löscht.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SourceBus

Gibt den Quell-IDE-Bus für das Laufwerk an.

Typ:Byte
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SourceLUN

Gibt die logische Quelleinheitsnummer (LUN) für ein virtuelles DVD-Laufwerkobjekt in einem IDE-Bus an.

Typ:Byte
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualDVDDrive

Gibt ein virtuelles DVD-Laufwerkobjekt an.

Typ:VirtualDVDDrive
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Hinweise

  • Erfordert ein virtuelles DVD-Laufwerkobjekt, das mithilfe des Cmdlets Get-SCVirtualDVDDrive abgerufen werden kann.