Partilhar via


New-SCVirtualScsiAdapter

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

Syntax

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 numa máquina virtual, modelo de máquina virtual ou perfil de hardware usado num ambiente virtual de Gestor de Máquinas (VMM). Depois de criar o adaptador SCSI virtual, pode utilizar o cmdlet Set-SCVirtualScsiAdapter para modificar as suas definições.

Nota: A utilização do parâmetro ShareVirtualScsiAdapter para partilhar um adaptador SCSI virtual numa máquina virtual para permitir o agrupamento de hóspedes só é suportada se a máquina virtual for implantada num anfitrião ESX. O parâmetro SharedVirtualScsiAdapter não é utilizado para uma máquina virtual num hospedeiro Hiper-V porque uma máquina virtual num hospedeiro Hiper-V utiliza o iSCSI para armazenamento partilhado.

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

Exemplos

Exemplo 1: Criar um adaptador SCSI virtual numa máquina virtual

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

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

O segundo comando cria um adaptador SCSI virtual em VM01.

Exemplo 2: Criar um adaptador SCSI virtual num 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 VMM e armazena o objeto na variável $VMTemplate.

O segundo comando cria um adaptador SCSI virtual em VMTemplate01.

Exemplo 3: Criar um adaptador SCSI virtual num 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 VMM e armazena o objeto na variável $HWProfile.

O segundo comando cria um adaptador SCSI virtual no NewHWProfile01.

Parâmetros

-AdapterID

Especifica o número da unidade lógica, ou LUN ID. O Hyper-V e o XenServer não expõem este valor e não podem ser alterados. Para um anfitrião VMware ESX, o padrão é 7 e não pode ser alterado.

Type:Byte
Position:0
Default value:None
Required:False
Accept pipeline input:True
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

-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

-OnBehalfOfUser

Especifica o nome de um utilizador. Este cmdlet define o utilizador em nome do utilizador como o 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. Este cmdlet define o papel do utilizador em nome do utilizador como a função de utilizador que este parâmetro especifica. Para obter um objeto de função do utilizador, utilize o cmdlet Get-SCUserRole .

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

-ScsiControllerType

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

  • Padrão DeType
  • NoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSi
  • LsiLogicSAS
Type:VMSCSIControllerType
Accepted values:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShareVirtualScsiAdapter

Indica se um adaptador SCSI virtual é partilhado para que possa ser usado no agrupamento de hóspedes.

  • Anfitrião Hiper-V: Não (para agrupamento de hóspedes, use armazenamento iSCSI)
  • XenServer host: No (Xen VMs sempre têm exatamente um adaptador SCSI)

Nota: Ao partilhar um controlador SCSI numa máquina virtual num hospedeiro ESX, a VMM predefini a política de partilha scsi em VMware para "física".

Type:Boolean
Aliases:Shared
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Synthetic

Indica que um dispositivo, como um adaptador de rede virtual, numa máquina virtual implantada num hospedeiro Hiper-V é um dispositivo sintético de alto desempenho. Requer um sistema operativo de hóspedes consciente da virtualização na máquina virtual.

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

-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

VirtualSCSIAdapter

Este cmdlet devolve um objeto VirtualSCSIAdapter .

Notas

  • Requer um objeto de máquina virtual VMM, um objeto de modelo de máquina virtual ou um objeto de perfil de hardware, que pode ser recuperado utilizando os cmdletes Get-SCVirtualMachine, Get-SCVMTemplate ou Get-SCHardwareProfile , respectivamente.