Compartilhar via

Set-SCVirtualScsiAdapter

  • Referência
Módulo:
VirtualMachineManager

Altera as propriedades de um adaptador SCSI virtual usado no VMM.

Sintaxe

Set-SCVirtualScsiAdapter
   [-ScsiControllerType <VMSCSIControllerType>]
   [-VirtualScsiAdapter] <VirtualSCSIAdapter>
   [-AdapterID <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVirtualScsiAdapter altera uma ou mais propriedades de um adaptador SCSI virtual usado em um ambiente do VMM (Virtual Machine Manager). As configurações que você pode modificar incluem especificar se um adaptador SCSI virtual é compartilhado ou não e definir a ID do adaptador.

Observação: usar o parâmetro ShareVirtualScsiAdapter para compartilhar um adaptador SCSI virtual em uma máquina virtual para habilitar o clustering convidado só terá suporte se a máquina virtual for implantada em um host VMware 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.

Observação: Set-SCVirtualScsiAdapter não é usado para hosts Citrix XenServer porque o adaptador SCSI em máquinas virtuais Citrix XenServer não é configurável.

Exemplos

Exemplo 1: Compartilhar um adaptador SCSI virtual específico em uma máquina virtual para habilitá-lo para clustering convidado

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualScsiAdapter -VM $VM 
PS C:\> Set-SCVirtualSCSIAdapter -VirtualScsiAdapter $Adapter -ShareVirtualScsiAdapter $True

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto do adaptador SCSI na VM01 e armazena o objeto na variável $Adapter. Este exemplo pressupõe que a VM01 tenha um adaptador SCSI virtual. No entanto, uma máquina virtual pode ter até quatro adaptadores SCSI virtuais anexados.

O último comando habilita o objeto do adaptador SCSI virtual armazenado em $Adapter e especifica que ele é compartilhado para que ele possa ser usado no clustering de convidado.

Observação: o uso do parâmetro Shared para compartilhar um adaptador SCSI virtual em uma máquina virtual só terá suporte se a máquina virtual for implantada em um host ESX. O parâmetro compartilhado não é usado para uma máquina virtual um host Hyper-V porque uma máquina virtual em um host Hyper-V usa iSCSI para armazenamento compartilhado. O parâmetro Shared também não é usado para uma máquina virtual em um host XenServer porque as máquinas virtuais baseadas em XenServer sempre têm exatamente um adaptador SCSI.

Parâmetros

-AdapterID

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

Tipo:Byte
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 ser executado.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUser

Especifica o nome de um usuário. Esse cmdlet define o nome do usuário como o usuário especificado por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Esse 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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScsiControllerType

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

  • DefaultType
  • NoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Tipo:VMSCSIControllerType
Valores aceitos:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ShareVirtualScsiAdapter

Indica se um adaptador SCSI virtual é compartilhado para que ele possa ser usado no clustering de convidados.

Tipo de host: Hyper-V host usa este parâmetro:

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

Observação: ao compartilhar um controlador SCSI em uma máquina virtual em um host ESX, o VMM usa como padrão a política de compartilhamento SCSI no VMware como "física".

Tipo:Boolean
Aliases:Shared
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VirtualScsiAdapter

Especifica um objeto de adaptador SCSI virtual para uma máquina virtual.

Tipo de número de host de adaptadores SCSI virtuais

Hyper-V: até quatro adaptadores SCSI virtuais sintéticos por VM e até 64 dispositivos por adaptador. Dá suporte a um tamanho de unidade de disco virtual de até 2040 GB. Não dá suporte a adaptadores SCSI virtuais emulados. VMware ESX: até quatro adaptadores SCSI virtuais por VM e até 15 dispositivos por adaptador. Dá suporte a um tamanho de unidade de disco virtual de até 2048 GB. Citrix XenServer: sempre um adaptador SCSI virtual por VM e até oito dispositivos por adaptador. Dá suporte a um tamanho de unidade de disco virtual de até 2048 GB.

Tipo:VirtualSCSIAdapter
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

VirtualSCSIAdapter

Esse cmdlet retorna um objeto VirtualScsiAdapter.

Observações

  • Requer um objeto do adaptador SCSI virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualScsiAdapter.