Skip to content

Commit 4fcbeaf

Browse files
authored
Update storage-files-identity-ad-ds-enable.md
customer has noted UPN is confusing with special characters
1 parent 23f868d commit 4fcbeaf

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

articles/storage/files/storage-files-identity-ad-ds-enable.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to enable Active Directory Domain Services authentication
44
author: khdownie
55
ms.service: azure-file-storage
66
ms.topic: how-to
7-
ms.date: 02/10/2025
7+
ms.date: 06/24/2025
88
ms.author: kendownie
99
ms.custom: engagement-fy23, devx-track-azurepowershell
1010
# Customer intent: As an IT administrator, I want to enable Active Directory Domain Services authentication for Azure file shares, so that our domain-joined Windows virtual machines can securely access and manage file shares using existing AD credentials.
@@ -173,6 +173,12 @@ The cmdlets should return the key value. Once you have the kerb1 key, create eit
173173
```powershell
174174
Set-ADUser -Identity $UserSamAccountName -UserPrincipalName cifs/<StorageAccountName>.file.core.windows.net@<DNSRoot>
175175
```
176+
> [!IMPORTANT]
177+
> ** Do **not** sync users with invalid **userPrincipalName (UPN)** values. UPNs must not contain special characters such as `/`, spaces, or other unsupported symbols.
178+
> Attempting to sync users with invalid UPNs (i.e. using `/` in the username) will result in Azure AD Connect errors.
179+
> If such identities exist in your on-premises directory, either:
180+
> - Update the UPN to a valid format (e.g., `[email protected]`), **or**
181+
> - Exclude the user from synchronization using filtering rules in Azure AD Connect.
176182
177183
3. Set the AD account password to the value of the kerb1 key.
178184

0 commit comments

Comments
 (0)