Compartilhar via

Remove-LocalGroup

  • Referência
Módulo:
Microsoft.PowerShell.LocalAccounts

Exclui grupos de segurança locais.

Sintaxe

Remove-LocalGroup
      [-InputObject] <LocalGroup[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroup
      [-Name] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroup
      [-SID] <SecurityIdentifier[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O Remove-LocalGroup cmdlet exclui grupos de segurança locais. Esse cmdlet exclui apenas um grupo local. Ele não exclui as contas de usuário, contas de computador ou contas de grupo que pertencem a esse grupo. Você não pode recuperar um grupo excluído.

Se você excluir um grupo e criar outro grupo com o mesmo nome de grupo, deverá definir novas permissões para o novo grupo. O novo grupo não herda as permissões que foram atribuídas ao grupo.

Observação

O módulo Microsoft.PowerShell.LocalAccounts não está disponível no PowerShell de 32 bits em um sistema de 64 bits.

Exemplos

Exemplo 1: Excluir um grupo de segurança

Remove-LocalGroup -Name "SecurityGroup04"

Esse comando exclui o grupo chamado SecurityGroup04.

Parâmetros

-Confirm

Solicita sua 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

-InputObject

Especifica uma matriz de grupos de segurança que esse cmdlet exclui. Para obter grupos, use o Get-LocalGroup cmdlet.

Tipo:Microsoft.PowerShell.Commands.LocalGroup[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica uma matriz de nomes dos grupos de segurança que esse cmdlet exclui.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SID

Especifica uma matriz de SIDs (IDs de segurança) de grupos de segurança que esse cmdlet exclui.

Tipo:SecurityIdentifier[]
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

Entradas

System.Management.Automation.SecurityAccountsManager.LocalGroup

Você pode canalizar um grupo de segurança para esse cmdlet.

String

Você pode canalizar uma cadeia de caracteres para esse cmdlet.

SecurityIdentifier

Você pode canalizar um SID para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

O Windows PowerShell inclui os seguintes aliases para Remove-LocalGroup:

  • rlg

Esse cmdlet não pode excluir os seguintes grupos padrão:

  • Administradores
  • Operadores de cópia
  • Operadores criptográficos
  • Usuários COM Distribuídos
  • Leitores de Log de Eventos
  • Guests
  • Administradores do Hyper-V
  • IIS_IUSRS
  • Operadores de Configuração de Rede
  • Usuários do Log de Desempenho
  • Usuários do monitor de desempenho
  • Usuários Avançados
  • Usuários da Área de Trabalho Remota
  • Usuários do gerenciamento remoto
  • Replicador
  • Usuários
  • WinRMRemoteWMIUsers__

A propriedade PrincipalSource é uma propriedade nos objetos LocalUser, LocalGroup e LocalPrincipal que descreve a origem do objeto. As fontes possíveis são as seguintes:

  • Local
  • Active Directory
  • Grupo do Microsoft Entra
  • Conta da Microsoft

PrincipalSource tem suporte apenas para Windows 10, Windows Server 2016 e versões posteriores do sistema operacional Windows. Para versões anteriores, a propriedade está em branco.