Set-SCVirtualDVDDrive

Ändert die Eigenschaften eines virtuellen DVD-Laufwerks, das einem virtuellen Computer, einer virtuellen Computervorlage oder einem Hardwareprofil zugeordnet ist, das in VMM verwendet wird.

Syntax

Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-NoMedia]
   -JobGroup <Guid>
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   -VMHostDrive <String>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   [-NoMedia]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   [-JobGroup <Guid>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-Link]
   -ISO <ISO>
   -JobGroup <Guid>
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   -VMHostDrive <String>
   -JobGroup <Guid>
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-Link]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   -ISO <ISO>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   -JobGroup <Guid>
   [-AnyVMHostDrive]
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   -JobGroup <Guid>
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-SCVirtualDVDDrive ändert eine oder mehrere Eigenschaften eines virtuellen DVD-Laufwerkobjekts, das einem virtuellen Computer, einer virtuellen Computervorlage oder einem Hardwareprofil zugeordnet ist, das in einer Virtuellen Computer-Manager-Umgebung (VMM) verwendet wird.

Sie können dieses Cmdlet verwenden, um ein virtuelles DVD-Laufwerk mit einem physischen DVD-Laufwerk auf einem virtuellen Computerhostserver, einem anderen Speicherort auf dem IDE-Bus oder einem ISO-Image zu verbinden, oder Sie können es verwenden, um das virtuelle DVD-Laufwerk zu trennen.

Die meisten Einstellungen, die Sie für ein virtuelles DVD-Laufwerk auf einem virtuellen Computer konfigurieren können, sind identisch, unabhängig davon, ob die Virtualisierungsplattform des Hosts Hyper-V, VMware oder Citrix XenServer ist. Alle diese Virtualisierungsplattformen unterstützen folgendes:

  • Verbinden eines virtuellen DVD-Laufwerks mit einem primären oder sekundären Kanal auf einem Host.

  • Erfassen von Informationen aus einem physischen CD- oder DVD-Laufwerk auf dem Host ohne Angabe eines Laufwerkbuchstabens.

  • Erfassen von Informationen aus einer in der VMM-Bibliothek gespeicherten Datei (ISO)

  • Erfassen von "keine Medien" (wird verwendet, um ein virtuelles DVD-Laufwerk vom Hostlaufwerk oder von einer ISO-Datei zu trennen).

Die einzige Einstellung, die für dieses Cmdlet nach Virtualisierungsplattform variiert, ist, ob eine ISO-Datei direkt aus der VMM-Bibliothek verwendet werden kann:

  • Hyper-V-Host. Wenn Sie eine Verbindung mit einer ISO-Datei in der VMM-Bibliothek konfigurieren, können Sie die ISO direkt aus der Bibliothek verwenden, anstatt sie in den Host zu kopieren.

  • VMware ESX-Host. Wenn Sie eine Verbindung mit einer ISO-Datei in der VMM-Bibliothek konfigurieren, können Sie die ISO-Datei nicht direkt aus der Bibliothek verwenden. Stattdessen müssen Sie die Standardeinstellung übernehmen, bei der die ISO-Datei auf den Host kopiert wird.

  • Citrix XenServer-Host. Wenn Sie eine Verbindung mit einer ISO-Datei in der VMM-Bibliothek konfigurieren, können Sie die ISO-Datei nicht direkt aus der Bibliothek verwenden. Stattdessen müssen Sie die Standardeinstellung übernehmen, bei der die ISO-Datei auf den Host kopiert wird. Der Host muss mindestens ein ISO-Repository mit Schreibzugriff und genügend Speicherplatz zur Verfügung haben, um die ISO-Datei zu enthalten.

Hinweis: Wenn das virtuelle DVD-Laufwerk auf einem virtuellen Computer konfiguriert ist, der mithilfe des Assistenten zum virtuellen Computer in der Hyper-V-Manager-Konsole erstellt wurde, anstatt in der VMM-Konsole, müssen Sie einen Laufwerkbuchstaben angeben. Dieser Laufwerkbuchstaben wird in den Eigenschaften für diesen virtuellen Computer in der VMM-Konsole angezeigt.

Beispiele

Beispiel 1: Verbinden eines virtuellen DVD-Laufwerks mit einem physischen DVD-Laufwerk

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

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 ab, das sich auf sekundären Kanal 0 (angegeben durch -Bus 1 und -LUN 0) auf dem IDE-Bus auf VM01 befindet und das Objekt in der $DVDDrive Variable speichert.

Der letzte Befehl verbindet das in $DVDDrive gespeicherte virtuelle DVD-Laufwerkobjekt mit einem physischen Laufwerk auf dem Host (D: Laufwerk). Außerdem werden alle vorher vom virtuellen DVD-Laufwerk vorher verwendeten ISO-Dateien gelöscht, wenn die jeweilige ISO-Datei zurzeit von keiner virtuellen Maschine verwendet wird.

Beispiel 2: Verbinden eines virtuellen DVD-Laufwerks an einem anderen Speicherort im IDE-Bus

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

Der Befehl ruft das virtuelle Computerobjekt namens VM02 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl ruft das virtuelle DVD-Laufwerkobjekt ab, das sich auf sekundären Kanal 0 (angegeben von -Bus 1 und -LUN 0) auf dem IDE-Bus auf VM02 befindet und dann das virtuelle DVD-Laufwerkobjekt in $DVDDrive speichert.

Der letzte Befehl verbindet das in $DVDDrive gespeicherte virtuelle DVD-Laufwerkobjekt mit einer anderen Position auf dem IDE-Bus, indem sie die logische Einheitsnummer (LUN) auf 1 festlegen.

Beispiel 3: Trennen eines virtuellen DVD-Laufwerks

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

Der erste Befehl ruft das virtuelle Computerobjekt namens VM03 ab und speichert das Objekt in der $VM Variable.

Der zweite Befehl ruft das virtuelle DVD-Laufwerkobjekt ab, das sich auf sekundären Kanal 0 (angegeben durch -Bus 1 und -LUN 0) auf dem IDE-Bus auf VM03 befindet und dann das virtuelle DVD-Laufwerkobjekt in $DVDDrive speichert.

Der letzte Befehl verwendet den NoMedia-Parameter , um das in $DVDDrive gespeicherte virtuelle DVD-Laufwerkobjekt von jedem Hostlaufwerk oder ISO zu trennen, mit dem er verbunden ist. Außerdem werden alle vorher vom virtuellen DVD-Laufwerk vorher verwendeten ISO-Dateien gelöscht, wenn die jeweilige ISO-Datei zurzeit von keiner virtuellen Maschine verwendet wird.

Beispiel 4: Verbinden eines virtuellen DVD-Laufwerks auf einem vorhandenen virtuellen Computer mit jedem verfügbaren physischen DVD-Laufwerk

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> Set-SCVirtualDVDDrive -AnyVMHostDrive -VirtualDVDDrive (Get-VirtualDVDDrive -VM $VM | where {$_.Bus -eq 1 -and $_.Lun -eq 0})

Der erste Befehl ruft das virtuelle Computerobjekt namens VM04 ab und speichert das Objekt in der $VM Variable.

Der letzte Befehl ruft das virtuelle DVD-Laufwerkobjekt ab, das sich im ersten Steckplatz des sekundären Kanals befindet (angegeben von -Bus 1 und -LUN 0) auf dem IDE-Bus auf VM04. Der Befehl verwendet das Cmdlet Set-SCVirtualDVDDrive mit dem Parameter AnyVMHostDrive , um das virtuelle DVD-Laufwerk mit jedem verfügbaren physischen DVD-Laufwerk auf dem Host zu verbinden.

Parameter

-AnyVMHostDrive

Gibt an, dass ein virtuelles DVD- oder Floppy-Laufwerk auf einem virtuellen Computer mit einem entsprechenden physischen Laufwerk auf einem Host verbunden ist. Diese Zuordnung tritt auf, wenn Sie einen gespeicherten virtuellen Computer auf einem Host bereitstellen oder ein Vorlagen- oder Hardwareprofil verwenden, um einen virtuellen Computer auf einem Host zu erstellen und bereitzustellen.

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

-Bus

Gibt den IDE-Bus an, mit dem ein virtuelles Laufwerk oder virtuelles DVD-Laufwerk verbunden werden soll, oder den SCSI-Bus, mit dem ein virtuelles Laufwerks verbunden werden soll.

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

-ISO

Gibt ein ISO-Objekt an.

Type:ISO
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

Gibt an, dass eine Ressource anstelle kopierter Ressourcen verknüpft werden soll.

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

-LUN

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

  • Beispielformat: -IDE -Bus 1 -LUN 0
  • Beispielformat: -SCSI -Bus 0 -LUN 1
Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoMedia

Trennt die Verbindung eines virtuellen DVD-Laufwerks mit dem Hostlaufwerk oder der ISO-Datei, mit dem bzw. der es verbunden war, oder trennt die Verbindung eines virtuellen Diskettenlaufwerks mit dem Hostlaufwerk oder der virtuellen Diskette, mit dem bzw. der es verbunden war.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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

-VMHostDrive

Gibt ein Laufwerk auf einem Host für virtuelle Maschinen an.

Beispiele für das Format:

  • Hyper-V-Hostlaufwerk: "C:"
  • Hyper-V-Host-Floppylaufwerk: "A:"
  • VMware ESX-Hostlaufwerk: "/dev/tools"
  • VMware ESX-Host-Floppylaufwerk: "/dev/sda"
  • Citrix XenServer-Hostlaufwerk: "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
  • Citrix XenServer-Host-Floppylaufwerk: Nicht unterstützt
Type:String
Aliases:HostDrive
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

VirtualDVDDrive

Dieses Cmdlet gibt ein VirtualDVDDrive-Objekt zurück.

Hinweise

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