Partilhar via

New-SCVirtualScsiAdapter

  • Referência
Módulo:
VirtualMachineManager

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

Sintaxe

New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -HardwareProfile <HardwareProfile>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -JobGroup <Guid>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet New-SCVirtualScsiAdapter cria um adaptador SCSI virtual em uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado em um ambiente do Virtual Machine Manager (VMM). Depois de criar o adaptador SCSI virtual, você pode usar o cmdlet Set-SCVirtualScsiAdapter para modificar suas configurações.

Nota: O uso do parâmetro ShareVirtualScsiAdapter para compartilhar um adaptador SCSI virtual em uma máquina virtual para habilitar o clustering convidado é suportado somente se a máquina virtual for implantada em um host ESX. O parâmetro SharedVirtualScsiAdapter não é usado para uma máquina virtual em um host Hyper-V porque uma máquina virtual em um host Hyper-V usa iSCSI para armazenamento compartilhado.

Uma máquina virtual em um host Citrix XenServer sempre tem um adaptador SCSI virtual. Não é possível remover este adaptador ou adicionar adaptadores adicionais.

Exemplos

Exemplo 1: Criar um adaptador SCSI virtual em uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualScsiAdapter -VM $VM

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 um adaptador SCSI virtual no VM01.

Exemplo 2: Criar um adaptador SCSI virtual em um modelo de máquina virtual

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

O primeiro comando obtém o objeto de modelo de máquina virtual chamado VMTemplate01 da biblioteca do VMM e armazena o objeto na variável $VMTemplate.

O segundo comando cria um adaptador SCSI virtual no VMTemplate01.

Exemplo 3: Criar um adaptador SCSI virtual em um perfil de hardware

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

O primeiro comando obtém o objeto de perfil de hardware chamado NewHWProfile01 da biblioteca do VMM e armazena o objeto na variável $HWProfile.

O segundo comando cria um adaptador SCSI virtual em NewHWProfile01.

Parâmetros

-AdapterID

Especifica o número da unidade lógica ou ID do LUN. Hyper-V e o XenServer não expõem esse valor e ele não pode ser alterado. Para um host VMware ESX, o padrão é 7 e não pode ser alterado.

Tipo:Byte
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
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

-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

-OnBehalfOfUser

Especifica o nome de um usuário. Este cmdlet define o em nome do usuário como o 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. Este cmdlet define a função em nome do usuário como a função de usuário especificada por esse parâmetro. Para obter um objeto de função de usuário, use o cmdlet Get-SCUserRole.

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

-ScsiControllerType

Especifica um tipo de controlador SCSI. Os valores válidos são:

  • DefaultType
  • NoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Tipo:VMSCSIControllerType
Valores aceites:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ShareVirtualScsiAdapter

Indica se um adaptador SCSI virtual é compartilhado para que possa ser usado em clustering convidado.

  • Hyper-V host: Não (para clustering convidado, use armazenamento iSCSI)
  • Host XenServer: Não (as VMs Xen sempre têm exatamente um adaptador SCSI)

Nota: Ao compartilhar um controlador SCSI em uma máquina virtual em um host ESX, o VMM padroniza a política de compartilhamento SCSI no VMware como "física".

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

-Synthetic

Indica que um dispositivo, como um adaptador de rede virtual, em uma máquina virtual implantada em um host Hyper-V é um dispositivo sintético de alto desempenho. Requer um sistema operacional convidado com reconhecimento de virtualização na máquina virtual.

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

-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

VirtualSCSIAdapter

Este cmdlet retorna um objeto VirtualSCSIAdapter.

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, que pode ser recuperado usando os cmdlets Get-SCVirtualMachine, Get-SCVMTemplateou Get-SCHardwareProfile, respectivamente.