Partilhar via

New-SCVirtualDVDDrive

  • Referência
Módulo:
VirtualMachineManager

Cria uma unidade de DVD virtual numa máquina virtual, num modelo de máquina virtual ou num perfil de hardware utilizado em 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 numa máquina virtual, um modelo de máquina virtual ou um perfil de hardware usado num ambiente virtual de Gestor de Máquinas (VMM). Por predefinição, a unidade virtual de DVD criada por New-SCVirtualDVDDrive não está ligada a nenhum meio de comunicação. Pode utilizar o cmdlet Set-SCVirtualDVDDrive para ligar uma unidade de DVD virtual a uma unidade de DVD físico num anfitrião de máquina virtual ou a uma imagem ISO.

Nota: Pode ligar uma unidade de DVD virtual a um dispositivo IDE numa máquina virtual, mas não é possível ligar uma unidade de DVD virtual a um adaptador SCSI numa máquina virtual.

Exemplos

Exemplo 1: Criar uma unidade de DVD virtual numa máquina virtual

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

O primeiro comando recebe o objeto da máquina virtual chamado VM01 e armazena o objeto na variável $VM.

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

Exemplo 2: Criar uma unidade de DVD virtual num 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 template da máquina virtual chamado VMTemplate01 e armazena o objeto na variável $Template.

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

Exemplo 3: Criar uma unidade de DVD virtual num 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 virtual de DVD no HardwareProfile1 que liga uma unidade virtual de DVD ao Canal Secundário (1) no autocarro IDE quando o perfil de hardware é usado para criar uma máquina virtual.

Exemplo 4: Criar uma máquina virtual com uma unidade virtual de DVD que se conecta a qualquer unidade de DVD físico disponível no anfitrião

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 GUID e armazena-a para $JobGroupID variáveis. Este GUID é um ID de grupo de trabalho que funciona como um identificador que agrupar comandos subsequentes que incluem este identificador em um único grupo de trabalho.

O segundo comando cria um novo objeto de unidade virtual de DVD e especifica que esta nova unidade de DVD virtual pode usar qualquer unidade de DVD físico disponível. O comando irá anexar a nova unidade de DVD virtual à primeira ranhura do segundo canal IDE (IDE é o único tipo de autocarro a que uma unidade virtual de DVD pode ser anexada). A utilização do ID do grupo de trabalho especifica que este comando só funciona antes do comando final que inclui o parâmetro do Grupo de Trabalho .

O terceiro comando recebe o objeto anfitrião chamado VMHost04 e armazena o objeto na variável $VMHost.

O último comando cria uma máquina virtual, dá-lhe o nome de VM04, fornece uma descrição, atribui um proprietário e especifica a localização do anfitrião para armazenar a máquina virtual. O comando utiliza o ID do grupo de trabalho para executar o comando New-SCVirtualDVDDrive pouco antes do comando New-SCVirtualMachine funcionar; o objeto de unidade virtual resultante do DVD está associado à nova máquina virtual.

Exemplo 5: Adicione uma nova unidade de DVD virtual a uma máquina virtual existente e anexe um ficheiro 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 recebe o objeto da 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 em VM05, liga-a à localização especificada no autocarro IDE e liga-a à imagem ISO armazenada em $ISO.

Parâmetros

-AnyVMHostDrive

Indica que um DVD virtual ou uma unidade floppy numa máquina virtual serão ligados a qualquer unidade física correspondente num hospedeiro. Este mapeamento ocorre quando implementa uma máquina virtual armazenada num hospedeiro ou quando utiliza um modelo ou perfil de hardware para criar e implantar uma máquina virtual num anfitrião.

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

-Bus

Especifica o ônibus IDE para anexar uma unidade de disco virtual ou unidade de DVD virtual, ou o ônibus SCSI ao qual se pode ligar 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 funcionarão como um conjunto pouco antes do comando final que inclui o mesmo identificador do grupo de trabalho.

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

-JobVariable

Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por este 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 ligado em vez de copiado.

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

-LUN

Especifica o número da unidade lógica (LUN) para um objeto de acionamento de disco virtual ou para um objeto de unidade de DVD virtual num autocarro IDE ou para um objeto de unidade de disco virtual num autocarro 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 utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.

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

-OnBehalfOfUserRole

Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.

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

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha 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 num anfitrião de máquina virtual.

Formatos de exemplo:

  • Disco rígido de anfitrião Hiper-V: "C:"
  • Unidade floppy do anfitrião hiper-V: "A:"
  • Disco rígido de anfitrião VMware ESX: "/dev/tools"
  • Unidade floppy do anfitrião VMware ESX: "/dev/sda"
  • Citrix XenServer anfitrião disco rígido: "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
  • Citrix XenServer anfitrião unidade floppy: Não suportado
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 VMM.

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

-VMTemplate

Especifica um objeto de modelo 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

Este cmdlet devolve um objeto VirtualDVDDrive .

Notas

  • Requer um objeto de máquina virtual VMM, objeto de modelo de máquina virtual ou objeto de perfil de hardware. Pode recuperar estes objetos utilizando os cmdletes Get-SCVirtualMachine, Get-SCVMTemplate ou Get-SCHardwareProfile , respectivamente.