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.