Troubleshoot Azure Files authentication with Active Directory

This article describes common issues related to Azure Files authentication with an Active Directory Domain Services (AD DS) domain or Azure Active Directory Domain Services (Azure AD DS) managed domain, and suggestions for how to fix them.

My group membership isn't working

When you add a virtual machine (VM) to an AD DS group, you must restart that VM to activate its membership within the service.

I can't add my storage account to my AD DS domain

First, check Unable to mount Azure Files with AD credentials to see if your problem is listed there.

Here are the most common reasons users may come across issues:

  • Ignoring any warning messages that appear when creating the account in PowerShell. Ignoring warnings may cause the new account to have incorrectly configured settings. To fix this issue, you should delete the domain account that represents the storage account and try again.

  • The account is using an incorrect organizational unit (OU). To fix this issue, reenter the OU information with the following syntax:


    For example:

  • If the storage account doesn't instantly appear in your Azure AD, don't worry. It usually takes 30 minutes for a new storage account to sync with Azure AD, so be patient. If the sync doesn't happen after 30 minutes, see the next section.

My AD DS group won't sync to Azure AD

If your storage account doesn't automatically sync with Azure AD after 30 minutes, you'll need to force the sync by using this script.

My storage account says it needs additional permissions

If your storage account needs additional permissions, you may not have assigned the required Azure role-based access control (RBAC) role to users or NTFS permissions. To fix this issue, make sure you've assigned one of these permissions to users who need to access the share:

  • The Storage File Data SMB Share Contributor RBAC permission.

  • The Read & Execute and List folder content NTFS permissions.

Next steps

If you need to refresh your memory about the Azure Files setup process, see Set up FSLogix Profile Container with Azure Files and Active Directory Domain Services or Azure Active Directory Domain Services.