Compartilhar via

New-LocalUser

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

Cria uma conta de usuário local.

Sintaxe

New-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-Disabled]
   [-FullName <String>]
   [-Name] <String>
   -Password <SecureString>
   [-PasswordNeverExpires]
   [-UserMayNotChangePassword]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-Disabled]
   [-FullName <String>]
   [-Name] <String>
   [-NoPassword]
   [-UserMayNotChangePassword]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O New-LocalUser cmdlet cria uma conta de usuário local. Esse cmdlet cria uma conta de usuário local.

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 uma conta de usuário

New-LocalUser -Name 'User02' -Description 'Description of this account.' -NoPassword

Name    Enabled  Description
----    -------  -----------
User02  True     Description of this account.

Esse comando cria uma conta de usuário local e não especifica os parâmetros AccountExpires ou Password . A conta não expira nem tem uma senha.

Exemplo 2: Criar uma conta de usuário que tenha uma senha

$Password = Read-Host -AsSecureString
$params = @{
    Name        = 'User03'
    Password    = $Password
    FullName    = 'Third User'
    Description = 'Description of this account.'
}
New-LocalUser @params

Name    Enabled  Description
----    -------  -----------
User03  True     Description of this account.

O primeiro comando usa o Read-Host cmdlet para solicitar uma senha. O comando armazena a senha como uma string segura na $Password variável.

O segundo comando cria uma conta de usuário local e define a senha da nova conta para a string segura armazenada no $Password. O comando especifica um nome de usuário, nome completo e descrição para a conta de usuário.

Parâmetros

-AccountExpires

Especifica quando a conta de usuário expira. Você pode usar o Get-Date cmdlet para obter um objeto DateTime . Se você não especificar esse parâmetro, a conta não expirará.

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

-AccountNeverExpires

Indica que a conta não expira.

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

-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 a conta de usuário. 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

-Disabled

Indica que esse cmdlet cria a conta de usuário como desabilitada.

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

-FullName

Especifica o nome completo da conta de usuário. O nome completo difere do nome de usuário da conta de usuário.

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

-Name

Especifica o nome de usuário para a conta de usuário.

Um nome de usuário pode conter até 20 caracteres maiúsculos ou minúsculos. Um nome de usuário não pode conter os seguintes caracteres:

", /, \, [, ]=,+:?;>|*<,@

Um nome de usuário não pode consistir apenas em pontos . ou espaços.

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

-NoPassword

Indica que a conta de usuário não tem uma senha.

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

-Password

Especifica uma senha para a conta de usuário. Você pode usar Read-Host -AsSecureString, Get-Credentialou ConvertTo-SecureString para criar um objeto SecureString para a senha.

Se você omitir os parâmetros Password e NoPassword , New-LocalUser solicitará a senha do novo usuário.

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

-PasswordNeverExpires

Indica se a senha do novo usuário expira.

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

-UserMayNotChangePassword

Indica que o usuário não pode alterar a senha na conta de usuário.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
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.

DateTime

Você pode canalizar um objeto DateTime para esse cmdlet.

Boolean

Você pode canalizar um valor booliano para esse cmdlet.

SecureString

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

Saídas

System.Management.Automation.SecurityAccountsManager.LocalUser

Esse cmdlet retorna um objeto LocalUser que representa a conta de usuário criada.

Observações

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

  • nlu

Um nome de usuário não pode ser idêntico a nenhum outro nome de usuário ou nome de grupo no computador. Um nome de usuário não pode consistir apenas em pontos . ou espaços. Um nome de usuário pode conter até 20 caracteres maiúsculos ou minúsculos. Um nome de usuário não pode conter os seguintes caracteres:

", /, \, [, ]=,+:?;>|*<,@

Uma senha pode conter até 127 caracteres.

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

Observação

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.