New-LocalGroup

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

Cria um grupo de segurança local.

Syntax

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.

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

-Description

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

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

-Name

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

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

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 é 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.