Skip to content

Commit e4f860b

Browse files
Merge pull request #260868 from khdownie/kendownie121123
Removing EncryptionType from Join-AzStorageAccount
2 parents caae29d + 7c18bbd commit e4f860b

File tree

1 file changed

+10
-8
lines changed

1 file changed

+10
-8
lines changed

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

Lines changed: 10 additions & 8 deletions
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: 10/19/2023
7+
ms.date: 01/12/2024
88
ms.author: kendownie
99
ms.custom: engagement-fy23, devx-track-azurepowershell
1010
recommendations: false
@@ -20,6 +20,7 @@ This article describes the process for enabling Active Directory Domain Services
2020
To enable AD DS authentication over SMB for Azure file shares, you need to register your Azure storage account with your on-premises AD DS and then set the required domain properties on the storage account. To register your storage account with AD DS, you create a computer account (or service logon account) representing it in your AD DS. Think of this process as if it were like creating an account representing an on-premises Windows file server in your AD DS. When the feature is enabled on the storage account, it applies to all new and existing file shares in the account.
2121

2222
## Applies to
23+
2324
| File share type | SMB | NFS |
2425
|-|:-:|:-:|
2526
| Standard file shares (GPv2), LRS/ZRS | ![Yes](../media/icons/yes-icon.png) | ![No](../media/icons/no-icon.png) |
@@ -28,7 +29,10 @@ To enable AD DS authentication over SMB for Azure file shares, you need to regis
2829

2930
## Option one (recommended): Use AzFilesHybrid PowerShell module
3031

31-
The AzFilesHybrid PowerShell module provides cmdlets for deploying and configuring Azure Files. It includes cmdlets for domain joining storage accounts to your on-premises Active Directory and configuring your DNS servers. The cmdlets make the necessary modifications and enable the feature for you. Because some parts of the cmdlets interact with your on-premises AD DS, we explain what the cmdlets do, so you can determine if the changes align with your compliance and security policies, and ensure you have the proper permissions to execute the cmdlets. Although we recommend using AzFilesHybrid module, if you're unable to do so, we provide [manual steps](#option-two-manually-perform-the-enablement-actions).
32+
The AzFilesHybrid PowerShell module provides cmdlets for deploying and configuring Azure Files. It includes cmdlets for domain joining storage accounts to your on-premises Active Directory and configuring your DNS servers. The cmdlets make the necessary modifications and enable the feature for you. Because some parts of the cmdlets interact with your on-premises AD DS, we explain what the cmdlets do, so you can determine if the changes align with your compliance and security policies, and ensure you have the proper permissions to execute the cmdlets. Although we recommend using the AzFilesHybrid module, if you're unable to do so, we provide [manual steps](#option-two-manually-perform-the-enablement-actions).
33+
34+
> [!IMPORTANT]
35+
> AES-256 Kerberos encryption is now the only encryption method supported by the AzFilesHybrid module. If you prefer to use RC4 encryption, see [Option two: Manually perform the enablement actions](#option-two-manually-perform-the-enablement-actions). If you previously enabled the feature with an old AzFilesHybrid version (below v0.2.2) that used RC4 as the default encryption method and want to update to support AES-256, see [troubleshoot Azure Files SMB authentication](/troubleshoot/azure/azure-storage/files-troubleshoot-smb-authentication?toc=/azure/storage/files/toc.json#azure-files-on-premises-ad-ds-authentication-support-for-aes-256-kerberos-encryption).
3236
3337
### Prerequisites
3438

@@ -38,7 +42,7 @@ The AzFilesHybrid PowerShell module provides cmdlets for deploying and configuri
3842

3943
### Download AzFilesHybrid module
4044

41-
[Download and unzip the latest version of the AzFilesHybrid module](https://github.com/Azure-Samples/azure-files-samples/releases). Note that AES-256 Kerberos encryption is supported on v0.2.2 or above, and is the default encryption method beginning in v0.2.5. If you've enabled the feature with an AzFilesHybrid version below v0.2.2 and want to update to support AES-256 Kerberos encryption, see [troubleshoot Azure Files SMB authentication](/troubleshoot/azure/azure-storage/files-troubleshoot-smb-authentication?toc=/azure/storage/files/toc.json#azure-files-on-premises-ad-ds-authentication-support-for-aes-256-kerberos-encryption).
45+
[Download and unzip the latest version of the AzFilesHybrid module](https://github.com/Azure-Samples/azure-files-samples/releases).
4246

4347
### Run Join-AzStorageAccount
4448

@@ -90,8 +94,7 @@ $DomainAccountType = "<ComputerAccount|ServiceLogonAccount>" # Default is set as
9094
# If you don't provide the OU name as an input parameter, the AD identity that represents the
9195
# storage account is created under the root directory.
9296
$OuDistinguishedName = "<ou-distinguishedname-here>"
93-
# Specify the encryption algorithm used for Kerberos authentication. Using AES256 is recommended.
94-
$EncryptionType = "<AES256|RC4|AES256,RC4>"
97+
# Encryption method is AES-256 Kerberos.
9598
9699
# Select the target subscription for the current session
97100
Select-AzSubscription -SubscriptionId $SubscriptionId
@@ -111,8 +114,7 @@ Join-AzStorageAccount `
111114
-StorageAccountName $StorageAccountName `
112115
-SamAccountName $SamAccountName `
113116
-DomainAccountType $DomainAccountType `
114-
-OrganizationalUnitDistinguishedName $OuDistinguishedName `
115-
-EncryptionType $EncryptionType
117+
-OrganizationalUnitDistinguishedName $OuDistinguishedName
116118
117119
# You can run the Debug-AzStorageAccountAuth cmdlet to conduct a set of basic checks on your AD configuration
118120
# with the logged on AD user. This cmdlet is supported on AzFilesHybrid v0.1.2+ version. For more details on
@@ -258,7 +260,7 @@ $storageAccount.AzureFilesIdentityBasedAuth.ActiveDirectoryProperties
258260

259261
If successful, the output should look like this:
260262

261-
```PowerShell
263+
```output
262264
DomainName:<yourDomainHere>
263265
NetBiosDomainName:<yourNetBiosDomainNameHere>
264266
ForestName:<yourForestNameHere>

0 commit comments

Comments
 (0)