Remove-SCVirtualScsiAdapter
Remove um objeto de adaptador SCSI virtual do VMM.
Sintaxe
Default (Predefinição)
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 Virtual Machine Manager (VMM).
O cmdlet Remove-SCVirtualSCSIAdapter remove um adaptador SCSI virtual com êxito somente se o adaptador não tiver nenhum dispositivo conectado a ele.
Uma máquina virtual em um host Citrix XenServer sempre tem um adaptador SCSI virtual. Não é possível remover este adaptador.
Este cmdlet retorna o objeto após o êxito (com a propriedade MarkedForDeletion definida como True) ou retorna uma mensagem de erro em caso de 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 no VM01 e armazena os objetos na matriz de objetos $Adapter. Uma máquina virtual pode ter até quatro adaptadores SCSI virtuais conectados. Este exemplo pressupõe que o 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 do VM01.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-JobGroup
Especifica um identificador para uma série de comandos que serão executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.
Propriedades dos parâmetros
| Tipo: | Guid |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-JobVariable
Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-OnBehalfOfUser
Especifica o nome de um usuário. Este cmdlet define o em nome do usuário como o usuário especificado por esse parâmetro.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-OnBehalfOfUserRole
Especifica uma função de usuário. Este 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.
Propriedades dos parâmetros
| Tipo: | UserRole |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-PROTipID
Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.
Propriedades dos parâmetros
| Tipo: | Guid |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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. Suporta um tamanho de unidade de disco virtual de 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 de 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 de até 2048 GB.
Propriedades dos parâmetros
| Tipo: | VirtualSCSIAdapter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Notas
- Requer um objeto de adaptador SCSI virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualScsiAdapter .