Compartilhar via

New-LocalUser

Módulo:
Microsoft.PowerShell.LocalAccounts Module

Cria uma conta de usuário local.

Sintaxe

Password (Default) 

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

NoPassword 

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

Description

O cmdlet New-LocalUser 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 ou 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 cmdlet Read-Host para solicitar uma senha. O comando armazena a senha como uma cadeia de caracteres segura na variável $Password.

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

Parâmetros

-AccountExpires

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

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-AccountNeverExpires

Indica que a conta não expira.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Description

Especifica um comentário para a conta de usuário. O comprimento máximo é de 48 caracteres.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Disabled

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Especifica o nome de usuário da conta de usuário.

Um nome de usuário pode conter até 20 caracteres maiúsculos ou caracteres 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 períodos . ou espaços.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-NoPassword

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NoPassword
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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 de Senha e NoPassword, New-LocalUser solicitará a senha do novo usuário.

Propriedades do parâmetro

Tipo:SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Password
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-PasswordNeverExpires

Indica se a senha do novo usuário expira.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Password
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-UserMayNotChangePassword

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 encaminhar uma cadeia de caracteres para este cmdlet.

DateTime

Você pode canalizar um objeto DateTime para este cmdlet.

Boolean

Você pode redirecionar um valor booliano para este cmdlet.

SecureString

Você pode canalizar uma cadeia de caracteres segura para este 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 períodos . ou espaços. Um nome de usuário pode conter até 20 caracteres maiúsculos ou caracteres 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, LocalGroupe 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 pelo Windows 10, Windows Server 2016 e versões posteriores do sistema operacional Windows. Em versões anteriores, a propriedade está em branco.