Compartilhar via

New-LocalGroup

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

Cria um grupo de segurança local.

Sintaxe

New-LocalGroup
   [-Description <String>]
   [-Name] <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O New-LocalGroup cmdlet cria um grupo de segurança local no Gerenciador de Contas de Segurança.

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: Criar um grupo de segurança

New-LocalGroup -Name "SecurityGroup04"

Esse comando cria um 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

-Description

Especifica um comentário para o grupo. O comprimento máximo é de 48 caracteres.

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

-Name

Especifica um nome para o grupo. O tamanho máximo é de 256 caracteres.

Tipo:String
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

String

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

Saídas

System.Management.Automation.SecurityAccountsManager.LocalGroup

Esse cmdlet retorna um objeto LocalGroup que representa o grupo de segurança criado.

Observações

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

  • nlg

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
  • AzureAD
  • MicrosoftAccount

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.