Partilhar via

Remove-LocalGroup

Módulo:
Microsoft.PowerShell.LocalAccounts Module

Exclui grupos de segurança locais.

Sintaxe

InputObject 

Remove-LocalGroup
    [-InputObject] <LocalGroup[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default 

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

SecurityIdentifier 

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

Description

O cmdlet Remove-LocalGroup exclui grupos de segurança locais. Este 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. Não é possível recuperar um grupo excluído.

Se você excluir um grupo e, em seguida, criar outro grupo que tenha 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"

Este comando exclui o grupo chamado SecurityGroup04.

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

-InputObject

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

Propriedades dos parâmetros

Tipo:

Microsoft.PowerShell.Commands.LocalGroup[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

InputObject
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Name

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Default
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-SID

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

Propriedades dos parâmetros

Tipo:

SecurityIdentifier[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SecurityIdentifier
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
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.

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 este cmdlet.

SecurityIdentifier

Você pode canalizar um SID para este cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

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

  • rlg

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

  • Administradores
  • Operadores de backup
  • Operadores Criptográficos
  • Usuários COM distribuídos
  • Leitores de log de eventos
  • Convidados
  • Administradores de Hyper-V
  • IIS_IUSRS
  • Operadores de configuração de rede
  • Utilizadores do log de desempenho
  • Usuários do Monitor de Desempenho
  • Utilizadores Avançados
  • Utilizadores do Ambiente de Trabalho Remoto
  • Utilizadores de Gestão Remota
  • Replicador
  • Utilizadores
  • WinRMRemoteWMIUsers__

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

  • Locais
  • Active Directory
  • Grupo Microsoft Entra
  • Conta Microsoft

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