Partilhar via

New-LocalGroup

Módulo:
Microsoft.PowerShell.LocalAccounts Module

Cria um grupo de segurança local.

Sintaxe

Default (Predefinição) 

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

Description

O cmdlet New-LocalGroup 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"

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

-Description

Indica um comentário para o grupo. O comprimento máximo é de 256 caracteres.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Name

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

Propriedades dos parâmetros

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

Conjuntos de parâmetros

(All)
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

String

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

Saídas

System.Management.Automation.SecurityAccountsManager.LocalGroup

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

Notas

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

  • nlg

A propriedade PrincipalSource é uma propriedade nos objetos LocalUser, LocalGroupe 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.