Configuración de las propiedades de la cuenta de usuario de Microsoft 365 con PowerShell

  • Artículo

Este artículo afecta tanto a Office 365 Enterprise como a Microsoft 365 Enterprise

Puede usar el Centro de administración de Microsoft 365 para configurar las propiedades de las cuentas de usuario de su inquilino de Microsoft 365. En PowerShell, también puede hacerlo, además de otras cosas que no puede hacer en el Centro de administración.

Configuración de las propiedades de la cuenta de usuario de Microsoft 365 con Microsoft Graph PowerShell

Nota:

El sdk de PowerShell de Microsoft Graph reemplaza el módulo de Azure Active Directory. Puede usar el SDK de PowerShell de Microsoft Graph para acceder a todas las API de Microsoft Graph. Para más información, consulte Introducción al SDK de PowerShell de Microsoft Graph.

En primer lugar, use un administrador de controlador de dominio de Microsoft Entra, una Administración de aplicación en la nube o una cuenta de administrador global para conectarse a su inquilino de Microsoft 365. Los cmdlets de este artículo requieren el ámbito de permiso User.ReadWrite.All o uno de los demás permisos enumerados en la página de referencia "List subscribedSkus" Graph API. Algunos comandos de este artículo pueden requerir ámbitos de permisos diferentes, en cuyo caso esto se anotará en la sección correspondiente.

Connect-MgGraph -Scopes "User.ReadWrite.All"

Cambiar las propiedades de una cuenta de usuario específica

La cuenta se identifica con el parámetro -ObjectID y se establecen o cambian propiedades específicas mediante parámetros adicionales. Esta es una lista de los parámetros más comunes:

  • -Department "<department name>"

  • -DisplayName "<nombre> de usuario completo"

  • -FacsimilieTelephoneNumber "<número> de fax"

  • -GivenName "<nombre> de usuario"

  • -Surname "<user last name>" (Apellidos de usuario)

  • -Móvil "<número> de teléfono móvil"

  • -JobTitle "<job title>"

  • -PreferredLanguage "<language>"

  • -StreetAddress "<street address>"

  • -City "<nombre de> ciudad"

  • -State "<state name>"

  • -PostalCode "<código> postal"

  • -Country "<country name>"

  • -TelephoneNumber "<número de> teléfono de la oficina"

  • -UsageLocation "<Código> de país o región de 2 caracteres"

    Este es el código de país o región de dos letras ISO 3166-1 alpha-2 (A2).

Nota:

Para poder asignar licencias a una cuenta de usuario, debe asignar una ubicación de uso.

Para mostrar el nombre principal de usuario (UPN) de las cuentas de usuario, ejecute el siguiente comando.

Get-MgUser -All | Sort-Object UserPrincipalName | Select-Object UserPrincipalName | More

Este comando indica a PowerShell que:

  1. Obtenga toda la información sobre las cuentas de usuario (Get-MgUser) y envíela al siguiente comando (|).

  2. Ordene la lista de UPN alfabéticamente (Ordenar UserPrincipalName) y envíela al siguiente comando (|).

  3. Mostrar solo la propiedad UPN para cada cuenta (Seleccione UserPrincipalName).

  4. Mostrar una pantalla a la vez (Más).

Para mostrar el UPN de una cuenta en función de su nombre para mostrar (nombre y apellido), ejecute los siguientes comandos. Rellene la variable $userName y quite los < caracteres y > :

$userName="<Display name>"
Write-Host (Get-MgUser -All | where {$_.DisplayName -eq $userName}).UserPrincipalName

En este ejemplo se muestra el UPN de la cuenta de usuario que tiene el nombre para mostrar Caleb Sills.

$userName="Caleb Sills"
Write-Host (Get-MgUser -All | where {$_.DisplayName -eq $userName}).UserPrincipalName

Mediante el uso de una variable de $upn , puede realizar cambios en cuentas individuales en función de su nombre para mostrar. Este es un ejemplo que establece la ubicación de uso de Belinda Newman en Francia. Pero especifica su nombre para mostrar en lugar de su UPN:

$userName="Belinda Newman"
$upn=(Get-MgUser | where {$_.DisplayName -eq $userName}).UserPrincipalName
Update-MgUser -UserId $upn -UsageLocation "FR"

Cambiar las propiedades de todas las cuentas de usuario

Para cambiar las propiedades de todos los usuarios, puede usar una combinación de los cmdlets Get-MgUser y Update-MgUser . En el ejemplo siguiente se cambia la ubicación de uso de todos los usuarios a Francia:

Get-MgUser | ForEach-Object { Update-MgUser -UserId $_.Id -UsageLocation "FR" }

Este comando indica a PowerShell que:

  1. Obtenga toda la información sobre las cuentas de usuario (Get-MgUser) y envíela al siguiente comando (|).

  2. Establezca la ubicación del usuario en Francia (Update-MgUser -UsageLocation FR).

Cambiar las propiedades de un conjunto específico de cuentas de usuario

Para cambiar las propiedades de un conjunto específico de cuentas de usuario, puede usar una combinación de los cmdlets Get-MgUser, Where y Update-MgUser . En el ejemplo siguiente se cambia la ubicación de uso de todos los usuarios del departamento de contabilidad a Francia:

Get-MgUser -All | Where-Object {$_.Department -eq "Accounting"} | ForEach-Object {Update-MgUser -UserId $_.Id -UsageLocation "FR"}

Este comando indica a PowerShell que:

  1. Obtenga toda la información sobre las cuentas de usuario (Get-MgUser) y envíela al siguiente comando (|).

  2. Busque todas las cuentas de usuario que tengan su propiedad Department establecida en "Contabilidad" (Where {$_. Department -eq "Accounting"}) y envíe la información resultante al siguiente comando (|).

  3. Establezca la ubicación del usuario en Francia (Update-MgUser -UsageLocation FR).

Vea también

Administrar cuentas de usuario, licencias y grupos de Microsoft 365 con PowerShell

Administrar Microsoft 365 con PowerShell

Introducción a PowerShell para Microsoft 365