New-LocalUser
Cria uma conta de usuário local.
Syntax
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. Este 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 cadeia de caracteres segura na $Password
variável.
O segundo comando cria uma conta de usuário local e define a senha da nova conta para a cadeia de caracteres 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á.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AccountNeverExpires
Indica que a conta não expira.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-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 a conta de usuário. O comprimento máximo é de 48 caracteres.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Disabled
Indica que esse cmdlet cria a conta de usuário como desabilitada.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-FullName
Especifica o nome completo da conta de usuário. O nome completo é diferente do nome de usuário da conta de usuário.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoPassword
Indica que a conta de usuário não tem uma senha.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Password
Especifica uma senha para a conta de usuário. Você pode usar Read-Host -AsSecureString
, Get-Credential
ou 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.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PasswordNeverExpires
Indica se a senha do novo usuário expira.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UserMayNotChangePassword
Indica que o usuário não pode alterar a senha na conta de usuário.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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
Você pode canalizar uma cadeia de caracteres para esse cmdlet.
Você pode canalizar um objeto DateTime para esse cmdlet.
Você pode canalizar um valor booleano para esse cmdlet.
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 qualquer 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 é 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.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de