Update-AzureRmADUser

Referencia

Módulo:: AzureRM.Resources

Novedades un usuario de Active Directory existente.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Update-AzureRmADUser
      -UPNOrObjectId <String>
      [-DisplayName <String>]
      [-EnableAccount <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADUser
      -UserPrincipalName <String>
      [-DisplayName <String>]
      [-EnableAccount <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADUser
      -ObjectId <Guid>
      [-DisplayName <String>]
      [-EnableAccount <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADUser
      -InputObject <PSADUser>
      [-DisplayName <String>]
      [-EnableAccount <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Novedades un usuario de Active Directory existente (cuenta profesional o educativa también conocida como org-id). Para obtener más información: https://msdn.microsoft.com/en-us/library/azure/ad/graph/api/users-operations#UpdateUser

Ejemplos

Ejemplo 1: actualización del nombre para mostrar de un usuario mediante el identificador de objeto

PS C:\> Update-AzureRmADUser -ObjectId 155a5c10-93a9-4941-a0df-96d83ab5ab24 -DisplayName MyNewDisplayName

Novedades el nombre para mostrar del usuario con el identificador de objeto '155a5c10-93a9-4941-a0df-96d83ab5ab5ab24' para que sea 'MyNewDisplayName'.

Ejemplo 2: actualización del nombre para mostrar de un usuario mediante el nombre principal de usuario

PS C:\> Update-AzureRmADUser -UserPrincipalName foo@domain.com -DisplayName MyNewDisplayName

Novedades el nombre para mostrar del usuario con el nombre principal de usuario "foo@domain.com" para que sea "MyNewDisplayName".

Ejemplo 3: actualización del nombre para mostrar de un usuario mediante tuberías

PS C:\> Get-AzureRmADUser -ObjectId 155a5c10-93a9-4941-a0df-96d83ab5ab24 | Update-AzureRmADUser -DisplayName MyNewDisplayName

Obtiene el usuario con el identificador de objeto '155a5c10-93a9-4941-a0df-96d83ab5ab5ab24' y canaliza el cmdlet Update-AzureRmADUser para actualizar el nombre para mostrar de ese usuario a 'MyNewDisplayName'.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisplayName

Nuevo nombre para mostrar para el usuario.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-EnableAccount

true para habilitar la cuenta; de lo contrario, false.

Tipo:	Nullable<T>[Boolean]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ForceChangePasswordNextLogin

Debe especificarse si el usuario debe cambiar la contraseña en el siguiente inicio de sesión correcto. Solo es válido si se actualiza la contraseña; de lo contrario, se omitirá.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Objeto que representa al usuario que se va a actualizar.

Tipo:	PSADUser
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ObjectId

Identificador de objeto del usuario que se va a actualizar.

Tipo:	Guid
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Password

Nueva contraseña para el usuario.

Tipo:	SecureString
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-UPNOrObjectId

Nombre principal de usuario o identificador de objeto del usuario que se va a actualizar.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-UserPrincipalName

Nombre principal de usuario del usuario que se va a actualizar.

Tipo:	String
Alias:	UPN
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False