Share via

Remove-SCVMHostGroup

  • Referência
Módulo:
VirtualMachineManager

Remove um grupo de hosts do VMM.

Syntax

Remove-SCVMHostGroup
      [-VMHostGroup] <HostGroup>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-SCVMHostGroup remove um ou mais objetos de grupo de hosts do banco de dados do VMM (Virtual Machine Manager). Um grupo de hosts não poderá ser excluído se ele estiver associado a uma nuvem privada, se tiver hosts atribuídos a ele ou se seu grupo de hosts filho tiver hosts atribuídos a ele. Esse cmdlet excluirá grupos de hosts filho se o grupo de hosts e seus grupos de hosts filho não contiverem hosts de máquina virtual.

Esse cmdlet retorna o objeto após o sucesso (com a propriedade MarkedForDeletion definida como True) ou retorna uma mensagem de erro após a falha.

Exemplos

Exemplo 1: Remover o grupo de hosts especificado

PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup02"
PS C:\> Remove-SCVMHostGroup -VMHostGroup $HostGroup

O primeiro comando obtém o grupo de hosts chamado HostGroup02 e o armazena na variável $HostGroup.

O segundo comando remove o objeto do grupo de hosts armazenado na variável $HostGroup.

Parâmetros

-Confirm

Solicita 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

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

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

-VMHostGroup

Especifica um objeto de grupo de host de máquina virtual.

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

-WhatIf

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

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

Observações

  • Requer um objeto de grupo de hosts do VMM, que pode ser recuperado usando o cmdlet Get-SCVMHostGroup .