Remove-SCVirtualScsiAdapter

  • Referência
Módulo:
VirtualMachineManager

Remove um objeto adaptador SCSI virtual do VMM.

Syntax

Remove-SCVirtualScsiAdapter
      [-VirtualScsiAdapter] <VirtualSCSIAdapter>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

O cmdlet Remove-SCVirtualScsiAdapter remove um ou mais objetos adaptadores SCSI virtuais de uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado num ambiente virtual de Gestor de Máquinas (VMM).

O cmdlet Remove-SCVirtualSCSIAdapter remove um adaptador SCSI virtual apenas com sucesso se o adaptador não tiver nenhum dispositivo ligado a ele.

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

Este cmdlet devolve o objeto após o sucesso (com a propriedade marcada para a Entrega de Imagem definida para Verdadeiro) ou devolve uma mensagem de erro após falha.

Exemplos

Exemplo 1: Remover o terceiro adaptador SCSI virtual de uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualSCSIAdapter -VM $VM 
PS C:\> $Adapter[2] | Remove-SCVirtualScsiAdapter

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

O segundo comando obtém todos os objetos adaptadores SCSI virtuais em VM01 e armazena os objetos na matriz de objetos $Adapter. Uma máquina virtual pode ter até quatro adaptadores SCSI virtuais ligados. Este exemplo pressupõe que o VM01 tem pelo menos três adaptadores SCSI virtuais.

O último comando passa o terceiro adaptador SCSI virtual ($Adapter[2]) para Remove-SCVirtualScsiAdapter, que remove este adaptador SCSI virtual do VM01.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
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:False
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

-VirtualScsiAdapter

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

Tipo de Número de Anfitrião de Adaptadores Virtuais SCSI

Hiper-V: Até quatro adaptadores sintéticos virtuais SCSI por VM e até 64 dispositivos por adaptador. Suporta um tamanho de unidade de disco virtual até 2040 GB. Não suporta adaptadores SCSI virtuais emulados. VMware ESX: Até quatro adaptadores SCSI virtuais por VM e até 15 dispositivos por adaptador. Suporta um tamanho de unidade de disco virtual até 2048 GB. Citrix XenServer: Sempre um adaptador SCSI virtual por VM e até oito dispositivos por adaptador. Suporta um tamanho de unidade de disco virtual até 2048 GB.

Type:VirtualSCSIAdapter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Notas

  • Requer um objeto adaptador SCSI virtual VMM, que pode ser recuperado utilizando o cmdlet Get-SCVirtualSiAdapter .