Freigeben über

New-SCVirtualDVDDrive

  • Referenz
Modul:
VirtualMachineManager

Erstellt ein virtuelles DVD-Laufwerk auf einem virtuellen Computer, eine Vorlage für virtuelle Computer oder ein Hardwareprofil, das in VMM verwendet wird.

Syntax

New-SCVirtualDVDDrive
   [-VMMServer <ServerConnection>]
   -Bus <Byte>
   -LUN <Byte>
   [-Link]
   -JobGroup <Guid>
   [-ISO <ISO>]
   [-VMHostDrive <String>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualDVDDrive
   -Bus <Byte>
   -LUN <Byte>
   [-Link]
   -HardwareProfile <HardwareProfile>
   [-ISO <ISO>]
   [-VMHostDrive <String>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualDVDDrive
   -Bus <Byte>
   -LUN <Byte>
   [-Link]
   -VM <VM>
   [-ISO <ISO>]
   [-VMHostDrive <String>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualDVDDrive
   -Bus <Byte>
   -LUN <Byte>
   [-Link]
   -VMTemplate <Template>
   [-ISO <ISO>]
   [-VMHostDrive <String>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCVirtualDVDDrive erstellt ein virtuelles DVD-Laufwerkobjekt auf einem virtuellen Computer, einer Vorlage für virtuelle Computer oder ein Hardwareprofil, das in einer VMM-Umgebung (Virtual Machine Manager) verwendet wird. Standardmäßig ist das von New-SCVirtualDVDDrive erstellte virtuelle DVD-Laufwerk nicht mit mediengebunden. Sie können das Cmdlet Set-SCVirtualDVDDrive verwenden, um ein virtuelles DVD-Laufwerk mit einem physischen DVD-Laufwerk auf einem Host eines virtuellen Computers oder mit einem ISO-Image zu verbinden.

Hinweis: Sie können ein virtuelles DVD-Laufwerk mit einem IDE-Gerät auf einem virtuellen Computer verbinden, aber Sie können kein virtuelles DVD-Laufwerk mit einem SCSI-Adapter auf einem virtuellen Computer verbinden.

Beispiele

Beispiel 1: Erstellen eines virtuellen DVD-Laufwerks auf einem virtuellen Computer

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualDVDDrive -VM $VM -Bus 1 -LUN 1

Der erste Befehl ruft das virtuelle Computerobjekt mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl erstellt ein virtuelles DVD-Laufwerk auf VM01 und fügt das virtuelle DVD-Laufwerk an sekundären Kanal (1) an, indem IDE Bus 1 und LUN 1 angegeben werden.

Beispiel 2: Erstellen eines virtuellen DVD-Laufwerks auf einer Vorlage für virtuelle Computer

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualDVDDrive -VMTemplate $VMTemplate -Bus 1 -LUN 1

Der erste Befehl ruft das templat-Objekt des virtuellen Computers mit dem Namen VMTemplate01 ab und speichert das Objekt in der $Template Variablen.

Der zweite Befehl erstellt ein virtuelles DVD-Laufwerk auf VMTemplate01, das ein virtuelles DVD-Laufwerk an sekundären Kanal (1) auf dem IDE-Bus anfügt, wenn die Vorlage zum Erstellen eines virtuellen Computers verwendet wird.

Beispiel 3: Erstellen eines virtuellen DVD-Laufwerks auf einem Hardwareprofil

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualDVDDrive -HardwareProfile $HWProfile -Bus 1 -LUN 1

Der erste Befehl ruft das Hardwareprofilobjekt namens NewHardwareProfile01 ab und speichert das Objekt in der $HWProfile Variablen.

Der zweite Befehl erstellt ein virtuelles DVD-Laufwerk auf HardwareProfile1, das ein virtuelles DVD-Laufwerk an sekundären Kanal (1) auf dem IDE-Bus anfügt, wenn das Hardwareprofil zum Erstellen eines virtuellen Computers verwendet wird.

Beispiel 4: Erstellen eines virtuellen Computers mit einem virtuellen DVD-Laufwerk, das eine Verbindung mit jedem verfügbaren physischen DVD-Laufwerk auf dem Host herstellt

PS C:\> $JobGroupId = [Guid]::NewGuid().ToString()
PS C:\> New-SCVirtualDVDDrive -VMMServer "VMMServer01.Contoso.com" -JobGroup $JobGroupId -Bus 1 -LUN 0 -AnyVMHostDrive 
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost04"
PS C:\> New-SCVirtualMachine -Name "VM04" -Description "A new VM with a DVD drive" -VMMServer "VMMServer01.Contoso.com" -Owner "Contoso\Katarina" -VMHost $VMHost -Path "D:\VirtualMachinePath" -StartVM -JobGroup $JobGroupId

Mit dem ersten Befehl wird eine neue GUID-Zeichenfolge erstellt und in der Variablen "$JobGroupID" gespeichert. Bei dieser GUID handelt es sich um eine Auftragsgruppen-ID, die als Bezeichner dient, mit dem nachfolgende Befehle, die diesen Bezeichner enthalten, zu einer Auftragsgruppe zusammengefasst werden.

Mit dem zweiten Befehl wird ein neues DVD-Laufwerksobjekt erstellt und angegeben, dass dieses neue virtuelle DVD-Laufwerk jedes verfügbare physische DVD-Laufwerk verwenden kann. Mit dem Befehl wird das neue virtuelle DVD-Laufwerk mit dem ersten Steckplatz des zweiten IDE-Kanals verbunden (IDE ist der einzige Bustyp, mit dem ein virtuelles DVD-Laufwerk verbunden werden kann). Die Verwendung der Auftragsgruppen-ID gibt an, dass dieser Befehl erst vor dem endgültigen Befehl ausgeführt wird, der den JobGroup-Parameter enthält.

Der dritte Befehl ruft das Hostobjekt namens VMHost04 ab und speichert das Objekt in der $VMHost Variablen.

Der letzte Befehl erstellt einen virtuellen Computer, benannt ihn VM04, stellt eine Beschreibung bereit, weist einen Besitzer zu und gibt den Speicherort auf dem Host an, um den virtuellen Computer zu speichern. Der Befehl verwendet die Auftragsgruppen-ID, um den Befehl "New-SCVirtualDVDDrive " direkt vor der Ausführung des befehls New-SCVirtualMachine auszuführen; das resultierende virtuelle DVD-Laufwerkobjekt ist dem neuen virtuellen Computer zugeordnet.

Beispiel 5: Hinzufügen eines neuen virtuellen DVD-Laufwerks zu einem vorhandenen virtuellen Computer und Anfügen einer ISO-Datei aus der Bibliothek an das Laufwerk

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $ISO = Get-SCISO | where {$_.Name -eq "WindowsServer2008R2.iso"}
PS C:\> New-SCVirtualDVDDrive -VM $VM -ISO $ISO -Bus 1 -LUN 1

Der erste Befehl ruft das virtuelle Computerobjekt mit dem Namen VM05 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl ruft das ISO-Objekt namens WindowsServer2008R2.iso ab und speichert das Objekt in der $ISO Variablen.

Der letzte Befehl erstellt ein neues virtuelles DVD-Laufwerk auf VM05, fügt es an den angegebenen Speicherort im IDE-Bus an und verknüpft es mit dem in $ISO gespeicherten ISO-Image.

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:False
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:True
Accept pipeline input:False
Accept wildcard characters:False

-HardwareProfile

Gibt ein Hardwareprofilobjekt an.

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

-ISO

Gibt ein ISO-Objekt an.

Type:ISO
Position:Named
Default value:None
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

-Link

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 Datenträgerlaufwerkobjekt oder für 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:True
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen 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. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen 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 des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der 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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-VM

Gibt ein Objekt virtueller Maschinen an.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

-VMTemplate

Gibt ein zum Erstellen virtueller Maschinen verwendetes VMM-Vorlagenobjekt an.

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

Ausgaben

VirtualDVDDrive

Dieses Cmdlet gibt ein VirtualDVDDrive-Objekt zurück.

Hinweise

  • Erfordert ein virtuelles VMM-Computerobjekt, ein Virtuelles Computervorlagenobjekt oder ein Hardwareprofilobjekt. Sie können diese Objekte mithilfe der Cmdlets "Get-SCVirtualMachine", "Get-SCVMTemplate" oder " Get-SCHardwareProfile" abrufen.