New-SCVirtualDVDDrive

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>]

Description

O cmdlet New-SCVirtualDVDDrive cria um objeto de unidade de DVD virtual em uma máquina virtual, um modelo de máquina virtual ou um perfil de hardware usado em um ambiente do VMM (Virtual Machine Manager). Por padrão, a unidade de DVD virtual criada pelo New-SCVirtualDVDDrive não está conectada a nenhuma mídia. Você pode usar o cmdlet Set-SCVirtualDVDDrive para conectar uma unidade de DVD virtual a uma unidade de DVD física em um host de máquina virtual ou a uma imagem ISO.

Observação: você pode conectar uma unidade de DVD virtual a um dispositivo IDE em uma máquina virtual, mas não pode conectar uma unidade de DVD virtual a um adaptador SCSI em uma máquina virtual.

Exemplos

Exemplo 1: criar uma unidade de DVD virtual em uma máquina virtual

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

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.

O segundo comando cria uma unidade de DVD virtual na VM01 e anexa a unidade de DVD virtual ao canal secundário (1) especificando o Barramento IDE 1 e o LUN 1.

Exemplo 2: criar uma unidade de DVD virtual em um modelo de máquina virtual

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

O primeiro comando obtém o objeto templat da máquina virtual chamado VMTemplate01 e armazena o objeto na variável $Template.

O segundo comando cria uma unidade de DVD virtual no VMTemplate01 que anexa uma unidade de DVD virtual ao Canal Secundário (1) no barramento IDE quando o modelo é usado para criar uma máquina virtual.

Exemplo 3: criar uma unidade de DVD virtual em um perfil de hardware

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

O primeiro comando obtém o objeto de perfil de hardware chamado NewHardwareProfile01 e armazena o objeto na variável $HWProfile.

O segundo comando cria uma unidade de DVD virtual no HardwareProfile1 que anexa uma unidade de DVD virtual ao Canal Secundário (1) no barramento do IDE quando o perfil de hardware é usado para criar uma máquina virtual.

Exemplo 4: criar uma máquina virtual com uma unidade de DVD virtual que se conecta a qualquer unidade de DVD físico disponível no host

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

O primeiro comando cria uma nova cadeia de caracteres GUID e a armazena na variável $JobGroupID. Esse GUID é uma ID de grupo de trabalho que funciona como um identificador que agrupa os comandos subsequentes que incluem esse identificador em um único grupo de trabalho.

O segundo comando cria um novo objeto de unidade de DVD virtual e especifica que essa nova unidade de DVD virtual pode usar qualquer unidade de DVD física disponível. O comando anexará a nova unidade de DVD virtual ao primeiro slot do segundo canal IDE (O IDE é o único tipo de barramento ao qual uma unidade de DVD virtual pode ser anexada). O uso da ID do grupo de trabalho especifica que esse comando não é executado até pouco antes do comando final que inclui o parâmetro JobGroup ser executado.

O terceiro comando obtém o objeto host chamado VMHost04 e armazena o objeto na variável $VMHost.

O último comando cria uma máquina virtual, nomeia-a VM04, fornece uma descrição, atribui um proprietário e especifica o local no host para armazenar a máquina virtual. O comando usa a ID do grupo de trabalho para executar o comando New-SCVirtualDVDDrive pouco antes da execução do comando New-SCVirtualMachine; o objeto de unidade de DVD virtual resultante está associado à nova máquina virtual.

Exemplo 5: adicionar uma nova unidade de DVD virtual a uma máquina virtual existente e anexar um arquivo ISO da biblioteca à unidade

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

O primeiro comando obtém o objeto de máquina virtual chamado VM05 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto ISO chamado WindowsServer2008R2.iso e armazena o objeto na variável $ISO.

O último comando cria uma nova unidade de DVD virtual na VM05, anexa-a ao local especificado no barramento IDE e a vincula à imagem ISO armazenada em $ISO.

Parâmetros

-AnyVMHostDrive

-Bus

-HardwareProfile

-ISO

-JobGroup

-JobVariable

-Link

-LUN

-OnBehalfOfUser

-OnBehalfOfUserRole

-PROTipID

-RunAsynchronously

-VM

-VMHostDrive

-VMMServer

-VMTemplate

Saídas

VirtualDVDDrive

Esse cmdlet retorna um objeto VirtualDVDDrive .

Observações

• Requer um objeto de máquina virtual do VMM, um objeto de modelo de máquina virtual ou um objeto de perfil de hardware. Você pode recuperar esses objetos usando os cmdlets Get-SCVirtualMachine, Get-SCVMTemplate ou Get-SCHardwareProfile , respectivamente.

Links Relacionados

• Get-SCHardwareProfile
• Get-SCISO
• Get-SCVirtualMachine
• Get-SCVirtualDVDDrive
• Get-SCVMHost
• Get-SCVMMServer
• Get-SCVMTemplate
• Remove-SCVirtualDVDDrive
• Set-SCVirtualDVDDrive