Compartilhar via

Remove-SCVirtualScsiAdapter

  • Referência
Módulo:
VirtualMachineManager

Remove um objeto do adaptador SCSI virtual do VMM.

Sintaxe

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 do adaptador SCSI virtual de uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado em um ambiente do VMM (Virtual Machine Manager).

O cmdlet Remove-SCVirtualSCSIAdapter remove um adaptador SCSI virtual com êxito somente se o adaptador não tiver nenhum dispositivo anexado a ele.

Uma máquina virtual em um host Citrix XenServer sempre tem um adaptador SCSI virtual. Não é possível remover esse adaptador.

Esse cmdlet retorna o objeto após o sucesso (com a propriedade MarkedForDeletion definida como True) ou retorna 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 obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.

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

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

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
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

-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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Observações

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