Skip to content

Commit f0bccd0

Browse files
Merge pull request #301790 from rladbsal/patch-26
Update storage-files-identity-ad-ds-enable.md
2 parents c39ef9c + f6cfe6a commit f0bccd0

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+
> **Don't 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 Microsoft Entra 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 Microsoft Entra Connect.
176182
177183
3. Set the AD account password to the value of the kerb1 key.
178184

0 commit comments

Comments
 (0)