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 eine oder mehrere virtuelle DVD-Laufwerkobjekte aus einem Hardwareprofil, einem virtuellen Computer oder einer virtuellen Computervorlage, die in einer Virtual Machine Manager -Umgebung (VMM) verwendet wird. Das Cmdlet löscht auch jede 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 eine Fehlermeldung zurück.

Beispiele

Beispiel 1: Entfernen eines bestimmten virtuellen DVD-Laufwerks aus 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 virtuelle Computerobjekt namens VM01 ab und speichert das Objekt in der $VM Variable.

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

Mit dem letzten Befehl wird das in "$DVDDrive" gespeicherte virtuelle DVD-Laufwerksobjekt von "VM01" entfernt, und alle von diesem virtuellen DVD-Laufwerk verwendeten ISO-Dateien werden aus dem Dateisystem auf dem Bibliothekserver gelöscht.

Beispiel 2: Entfernen des dritten virtuellen DVD-Laufwerks aus 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 virtuelle Computerobjekt namens VM02 ab und speichert das Objekt in der $VM Variable.

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 das Array daher drei Elemente enthält (Zählung von 0 bis 2).

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

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz unmittelbar vor dem letzten Befehl, der den gleichen Auftragsgruppenbezeichner enthält, ausgeführt werden.

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-PROTipID

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

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-SourceBus

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

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

-SourceLUN

Gibt die Quell-logische Einheitsnummer (LUN) für ein virtuelles DVD-Laufwerkobjekt auf einem IDE-Bus an.

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

-VirtualDVDDrive

Gibt ein virtuelles DVD-Laufwerksobjekt an.

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

-WhatIf

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

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

Hinweise

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