Set-MsolUser

Modifica um usuário no Azure Active Directory.

Syntax

Set-MsolUser
   [-ImmutableId <String>]
   [-ObjectId <Guid>]
   [-UserPrincipalName <String>]
   [-BlockCredential <Boolean>]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DisplayName <String>]
   [-Fax <String>]
   [-FirstName <String>]
   [-LastName <String>]
   [-LastPasswordChangeTimestamp <DateTime>]
   [-MobilePhone <String>]
   [-Office <String>]
   [-PasswordNeverExpires <Boolean>]
   [-PhoneNumber <String>]
   [-PostalCode <String>]
   [-PreferredDataLocation <String>]
   [-PreferredLanguage <String>]
   [-SoftDeletionTimestamp <DateTime>]
   [-State <String>]
   [-StreetAddress <String>]
   [-StrongPasswordRequired <Boolean>]
   [-Title <String>]
   [-UsageLocation <String>]
   [-AlternateEmailAddresses <String[]>]
   [-StrongAuthenticationMethods <StrongAuthenticationMethod[]>]
   [-AlternateMobilePhones <String[]>]
   [-StrongAuthenticationRequirements <StrongAuthenticationRequirement[]>]
   [-StsRefreshTokensValidFrom <DateTime>]
   [-UserType <UserType>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

O cmdlet Set-MsolUser modifica um objeto de usuário.

Use este cmdlet somente para atualizações de propriedades básicas. Atualize as licenças, a senha e o nome da entidade de usuário para um usuário usando os cmdlets Set-MsolUserLicense, Set-MsolUserPassword e Set-MsolUserPrincipalName .

Exemplos

Exemplo 1: Bloquear credencial para um usuário

PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -BlockCredential $True

Esse comando define a credencial de bloco como $True para um usuário, o que os impede de entrar. Isso não pode ser feito para um usuário sincronizado.

Exemplo 2: Atualizar nome de exibição

PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -Title "Manager" -Department "Finance"

Esse comando atualiza o nome de exibição do usuário especificado.

Exemplo 3: Definir o local de um usuário

PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -UsageLocation "CA"

Esse comando define o país de localização ou a região de um usuário. O país ou região deve ser um código ISO de duas letras. Este pode ser definido para usuários sincronizados e para usuários gerenciados.

Exemplo 4: Definir o local de dados preferencial

PS C:\> Set-MsolUser -UserPrincipalName "davidchew@contoso.com" -PreferredDataLocation "EUR"

Esse comando define a propriedade de local de dados preferencial de um usuário cujo nome de entidade de usuário é davidchew@contoso.com EUR.

Parâmetros

-AlternateEmailAddresses

Especifica endereços de email alternativos para o usuário.

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

-AlternateMobilePhones

Especifica números de telefone celular alternativos para o usuário.

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

-BlockCredential

Especifica se o usuário não consegue fazer logon usando sua ID de usuário.

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

-City

Especifica a cidade do usuário.

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

-Country

Especifica o país ou a região do usuário.

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

-Department

Especifica o departamento do usuário.

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

-DisplayName

Especifica o nome de exibição do usuário.

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

-Fax

Especifica o número de fax do usuário.

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

-FirstName

Especifica o nome do usuário.

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

-ImmutableId

Especifica a ID imutável da identidade federada do usuário. Isso deve ser omitido para usuários com identidades padrão.

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

-LastName

Especifica o sobrenome do usuário.

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

-LastPasswordChangeTimestamp

Especifica uma hora em que a senha foi alterada pela última vez.

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

-MobilePhone

Especifica o número de telefone celular do usuário.

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

-ObjectId

Especifica a ID de objeto exclusiva do usuário.

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

-Office

Especifica o local do escritório do usuário.

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

-PasswordNeverExpires

Especifica se a senha do usuário expira periodicamente.

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

-PhoneNumber

Especifica o número de telefone do usuário.

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

-PostalCode

Especifica o código postal do usuário.

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

-PreferredDataLocation

Especifica o local de dados preferencial para o usuário.

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

-PreferredLanguage

Especifica o idioma preferencial do usuário.

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

-SoftDeletionTimestamp

Especifica um tempo para exclusão temporária.

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

-State

Especifica o estado ou a província em que o usuário está localizado.

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

-StreetAddress

Especifica o endereço de rua do usuário.

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

-StrongAuthenticationMethods

Especifica uma matriz de métodos de autenticação forte.

Type:StrongAuthenticationMethod[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StrongAuthenticationRequirements

Especifica uma matriz de requisitos de autenticação fortes.

Type:StrongAuthenticationRequirement[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StrongPasswordRequired

Especifica se é necessário exigir uma senha forte para o usuário.

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

-StsRefreshTokensValidFrom

Especifica um valor StsRefreshTokensValidFrom.

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

-TenantId

Especifica a ID exclusiva do locatário no qual executar a operação. O valor padrão é o locatário do usuário atual. Esse parâmetro se aplica somente a usuários parceiros.

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

-Title

Especifica o título do usuário.

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

-UsageLocation

Especifica o local do usuário em que os serviços são consumidos. Especifique um código de país ou região de duas letras.

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

-UserPrincipalName

Especifica a ID de usuário do usuário.

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

-UserType

Especifica o tipo de usuário.

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