Partilhar via

New-SCVirtualDVDDrive

  • Referência
Módulo:
VirtualMachineManager

Cria uma unidade de DVD virtual em uma máquina virtual, um modelo de máquina virtual ou um perfil de hardware usado no VMM.

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

Indica que um DVD virtual ou uma unidade de disquete em uma máquina virtual será conectado a qualquer unidade física correspondente em um host. Esse mapeamento ocorre quando você implanta uma máquina virtual armazenada em um host ou quando usa um modelo ou perfil de hardware para criar e implantar uma máquina virtual em um host.

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

-Bus

Especifica o barramento IDE ao qual anexar uma unidade de disco virtual ou uma unidade de DVD virtual ou o barramento SCSI ao qual anexar uma unidade de disco virtual.

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

-HardwareProfile

Especifica um objeto de perfil de hardware.

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

-ISO

Especifica um objeto ISO.

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

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho executado.

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

-JobVariable

Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

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

-Link

Indica que um recurso deve ser vinculado em vez de copiado.

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

-LUN

Especifica o LUN (número de unidade lógica) para um objeto de unidade de disco virtual ou para um objeto de unidade de DVD virtual em um barramento IDE ou para um objeto de unidade de disco virtual em um barramento SCSI.

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

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

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

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole . Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

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

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.

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

-VM

Especifica um objeto de máquina virtual.

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

-VMHostDrive

Especifica uma unidade em um host de máquina virtual.

Formatos de exemplo:

  • Disco rígido do host Hyper-V: "C:"
  • Unidade de disquete do host Hyper-V: "A:"
  • Disco rígido do host ESX do VMware: "/dev/tools"
  • Unidade de disquete de host do VMware ESX: "/dev/sda"
  • Disco rígido do host do Citrix XenServer: "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
  • Unidade de disquete do host Citrix XenServer: não há suporte
Type:String
Aliases:HostDrive
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Especifica um objeto de servidor do VMM.

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

-VMTemplate

Especifica um objeto de modelo do VMM usado para criar máquinas virtuais.

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

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.