Freigeben über

Remove-SCVirtualDVDDrive

Modul:
VirtualMachineManager Module

Entfernt ein virtuelles DVD-Laufwerkobjekt aus VMM.

Syntax

VirtualDVDDriveSpecified 

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

SourceBusAndLunSpecified 

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

Beschreibung

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

Dieses Cmdlet gibt das Objekt bei Erfolg zurück (wobei die Eigenschaft MarkedForDeletion auf True festgelegt ist) oder gibt eine Fehlermeldung zurück, wenn ein Fehler auftritt.

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-Laufwerksobjekt ab, das sich auf dem ersten Steckplatz des sekundären Kanals (angegeben durch -Bus 1 und -LUN 0) auf dem IDE-Bus auf VM01 befindet, und speichert dann das virtuelle DVD-Laufwerksobjekt in der Variablen $DVDDrive.

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

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 VM-Objekt mit dem Namen VM02 ab und speichert das Objekt in der Variablen $VM.

Der zweite Befehl ruft alle virtuellen DVD-Laufwerksobjekte ab, die mit VM02 verbunden sind, und speichert jedes virtuelle DVD-Laufwerksobjekt 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 (von 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 Dateien, die von diesem virtuellen DVD-Laufwerk verwendet werden, aus dem Dateisystem auf dem Bibliothekserver löscht.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

VirtualDVDDriveSpecified
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, der durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:UserRole
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SourceBus

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

Parametereigenschaften

Typ:Byte
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SourceBusAndLunSpecified
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SourceLUN

Gibt die LUN (Source Logical Unit Number) für ein virtuelles DVD-Laufwerksobjekt auf einem IDE-Bus an.

Parametereigenschaften

Typ:Byte
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SourceBusAndLunSpecified
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualDVDDrive

Gibt ein virtuelles DVD-Laufwerksobjekt an.

Parametereigenschaften

Typ:VirtualDVDDrive
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

VirtualDVDDriveSpecified
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Hinweise

  • Erfordert ein virtuelles VMM-DVD-Laufwerksobjekt, das mit dem Cmdlet Get-SCVirtualDVDDrive abgerufen werden kann.