New-SCVirtualDVDDrive
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 1O 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 1O 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 1O 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 $JobGroupIdO 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 1O 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.