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.

Sintaxe

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 Virtual Machine Manager (VMM). Por padrão, a unidade de DVD virtual criada por 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.

Nota: 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 no VM01 e anexa a unidade de DVD virtual ao canal secundário (1) especificando IDE Bus 1 e 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 de modelo de 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 em HardwareProfile1 que anexa uma unidade de DVD virtual ao Canal Secundário (1) no barramento 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ísica 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 é um ID de grupo de trabalho que funciona como um identificador que agrupa comandos subsequentes que incluem esse identificador em um único grupo de trabalhos.

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 conectada). O uso da ID do grupo de trabalho especifica que esse comando não é executado até pouco antes da execução do comando final que inclui o parâmetro JobGroup.

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 no VM05, anexa-a ao local especificado no barramento IDE e a vincula à imagem ISO armazenada no $ISO.

Parâmetros

-AnyVMHostDrive

Indica que um DVD virtual ou 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.

Tipo:SwitchParameter
Aliases:AnyHostDrive
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Bus

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

Tipo:Byte
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HardwareProfile

Especifica um objeto de perfil de hardware.

Tipo:HardwareProfile
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ISO

Especifica um objeto ISO.

Tipo:ISO
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.

Tipo:Guid
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Link

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LUN

Especifica o número da unidade lógica (LUN) 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.

  • Exemplo de formato: -IDE -Bus 1 -LUN 0
  • Exemplo de formato: -SCSI -Bus 0 -LUN 1
Tipo:Byte
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUser

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUserRole

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

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VM

Especifica um objeto de máquina virtual.

Tipo:VM
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VMHostDrive

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

Exemplos de formatos:

  • Hyper-V disco rígido do host: "C:"
  • Hyper-V unidade de disquete do host: "A:"
  • Disco rígido host VMware ESX: "/dev/tools"
  • Unidade de disquete host VMware ESX: "/dev/sda"
  • Disco rígido host Citrix XenServer: "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
  • Unidade de disquete host Citrix XenServer: não suportada
Tipo:String
Aliases:HostDrive
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VMTemplate

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

Tipo:Template
Aliases:Template
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

VirtualDVDDrive

Este cmdlet retorna um objeto VirtualDVDDrive.

Notas

  • 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-SCVMTemplateou Get-SCHardwareProfile, respectivamente.