Guide: Adjusting Language Settings in Azure Active Directory

Introduction

This guide describes how to adjust the language settings for users in Azure Active Directory (Azure AD).

Guardey is available in over 10 languages. The preferred language of the users is also passed through via Azure AD parameters. This cannot (yet) be changed within Guardey itself. By default, the English language is passed from Azure AD. Do you want users to have another language in Guardey? Then make sure the language parameter of the user in Azure AD is set correctly.

Requirements

• Access to the Azure portal with administrator rights.
• Windows PowerShell.

Step 1: Install the AzureAD Module

1. Open Windows PowerShell as an administrator.
2. Run the following command to install the AzureAD module:
   powershell

   Install-Module AzureAD -Scope CurrentUser
3. You may receive a message that the NuGet provider needs to be installed. Confirm this by typing Y and pressing Enter.

Step 2: Connect to Azure AD

1. Open Windows PowerShell if it is not already open.
2. Run the following command to connect to Azure AD:
   powershell

   Connect-AzureAD
3. A login window will appear. Enter the credentials of your Azure AD administrator account.

Step 3: Adjust Language Settings for Users

Option 1: Adjust Language Setting for a Single User

1. Run the following command to set the language preference for a specific user:
   powershell

   Set-AzureADUser -ObjectId "user@example.com" -PreferredLanguage "nl"
   Replace "user@example.com" with the email address or ObjectId of the user.

Option 2: Adjust Language Setting for All Users

1. Retrieve all users with the following command:
   powershell

   $users = Get-AzureADUser -All $true
2. Set the language for all users using a foreach loop:
   powershell

   foreach ($user in $users) { Set-AzureADUser -ObjectId $user.ObjectId -PreferredLanguage "nl" }

Step 4: Verify the Changes

1. Run the following command to verify that the language setting has been applied correctly:
   powershell

   Get-AzureADUser -ObjectId "user@example.com" | Select-Object PreferredLanguage
   Replace "user@example.com" with the email address or ObjectId of the user.

Frequently Asked Questions

What if I get an error during the installation of the AzureAD module?

• Make sure you have opened PowerShell with administrator rights. Right-click on the PowerShell icon and select "Run as administrator."

Can I adjust the language settings for a specific group of users?

• Yes, you can filter users based on certain criteria (such as job title) and then adjust the language settings for this group. For example:
  powershell

  $users = Get-AzureADUser -Filter "JobTitle eq 'Sales'" foreach ($user in $users) { Set-AzureADUser -ObjectId $user.ObjectId -PreferredLanguage "nl" }

By following these steps, you can easily adjust the language settings for users in Azure AD. This ensures that all users have the correct language settings for their Guardey account.

Of course, you can also choose a language other than Dutch. We use the ISO 639-1 two-letter format for this field, e.g., "en" or "nl".

Note! This changes the user's language choice within any other apps that are also linked to the language choice via Azure AD.