New-SCVirtualDVDDrive
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 1Der 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 1Der 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 1Der 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 $JobGroupIdMit 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 1Der 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.