Configurare le proprietà dell'account utente di Microsoft 365 con PowerShell

Questo articolo si applica sia a Microsoft 365 Enterprise che a Office 365 Enterprise.

È possibile usare l'interfaccia di amministrazione di Microsoft 365 per configurare le proprietà per gli account utente del tenant di Microsoft 365. In PowerShell è anche possibile eseguire questa operazione, oltre ad altre operazioni che non è possibile eseguire nell'interfaccia di amministrazione.

Configurare le proprietà dell'account utente di Microsoft 365 con Microsoft Graph PowerShell

Nota

Il modulo Azure Active Directory viene sostituito da Microsoft Graph PowerShell SDK. È possibile usare Microsoft Graph PowerShell SDK per accedere a tutte le API di Microsoft Graph. Per altre informazioni, vedere Inizia a usare Attività iniziali con Microsoft Graph PowerShell SDK.

Per prima cosa, usare un account amministratore di Microsoft Entra DC o cloud application admin per connettersi al tenant di Microsoft 365. I cmdlet in questo articolo richiedono l'ambito di autorizzazione User.ReadWrite.All o una delle altre autorizzazioni elencate nella pagina di riferimento dell'API Graph 'List subscribedSkus'. Alcuni comandi in questo articolo possono richiedere ambiti di autorizzazione diversi, nel qual caso questa operazione verrà annotata nella sezione pertinente.

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

Modificare le proprietà per un account utente specifico

Identificare l'account con il parametro -ObjectID e impostare o modificare proprietà specifiche usando parametri aggiuntivi. Ecco un elenco dei parametri più comuni:

  • -Department "<department name>"

  • -DisplayName "<nome> utente completo"

  • -FacsimilieTelephoneNumber "<fax number>"

  • -GivenName "<nome> utente"

  • -Cognome "<cognome> utente"

  • -Mobile "<numero di> telefono cellulare"

  • -JobTitle "<job title>"

  • -PreferredLanguage "<language>"

  • -StreetAddress "<indirizzo stradale>"

  • -Città "<nome> città"

  • -State "<state name>"

  • -PostalCode "<codice> postale"

  • -Paese "<nome> paese"

  • -TelephoneNumber "<numero di telefono dell'ufficio>"

  • -UsageLocation "<Codice paese o area> geografica a 2 caratteri"

    Si tratta del codice paese o area geografica a due lettere ISO 3166-1 alpha-2 (A2).

Nota

Prima di poter assegnare licenze a un account utente, è necessario assegnare una posizione di utilizzo.

Per visualizzare il nome dell'entità utente (UPN) per gli account utente, eseguire il comando seguente.

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

Questo comando indica a PowerShell di:

  1. Ottenere tutte le informazioni sugli account utente (Get-MgUser) e inviarle al comando successivo (|).

  2. Ordinare l'elenco di UPN in ordine alfabetico (Ordina UserPrincipalName) e inviarlo al comando successivo (|).

  3. Visualizzare solo la proprietà UPN per ogni account (Selezionare UserPrincipalName).

  4. Visualizzare gli elementi in una schermata alla volta (More).

Per visualizzare l'UPN per un account in base al nome visualizzato (nome e cognome), eseguire i comandi seguenti. Compilare la variabile $userName e rimuovere i < caratteri e > :

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

In questo esempio viene visualizzato l'UPN per l'account utente con il nome visualizzato Caleb Sills.

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

Utilizzando una variabile $upn, è possibile apportare modifiche ai singoli account in base al nome visualizzato. Ecco un esempio che imposta la posizione di utilizzo di Belinda Newman su Francia. Ma specifica il nome visualizzato anziché l'UPN:

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

Modificare le proprietà per tutti gli account utente

Per modificare le proprietà per tutti gli utenti, è possibile usare una combinazione dei cmdlet Get-MgUser e Update-MgUser . Nell'esempio seguente viene modificata la posizione di utilizzo per tutti gli utenti in Francia:

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

Questo comando indica a PowerShell di:

  1. Ottenere tutte le informazioni sugli account utente (Get-MgUser) e inviarle al comando successivo (|).

  2. Impostare la posizione utente su Francia (Update-MgUser -UsageLocation FR).

Modificare le proprietà per un set specifico di account utente

Per modificare le proprietà per un set specifico di account utente, è possibile usare una combinazione dei cmdlet Get-MgUser, Where e Update-MgUser . Nell'esempio seguente la posizione di utilizzo per tutti gli utenti del reparto Contabilità viene modificata in Francia:

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

Questo comando indica a PowerShell di:

  1. Ottenere tutte le informazioni sugli account utente (Get-MgUser) e inviarle al comando successivo (|).

  2. Trovare tutti gli account utente per i quali la proprietà Department è impostata su "Contabilità" (dove {$_. Department -eq "Accounting"}) e inviare le informazioni risultanti al comando successivo (|).

  3. Impostare la posizione utente su Francia (Update-MgUser -UsageLocation FR).

Vedere anche

Gestire gli account utente, le licenze e i gruppi di Microsoft 365 con PowerShell

Gestire Microsoft 365 con PowerShell

Guida introduttiva a PowerShell per Microsoft 365