Skip to content

Commit 2b5c55b

Browse files
committed
More Acrolinx fixes.
1 parent 7a3a6bf commit 2b5c55b

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

articles/storage/files/storage-files-identity-ad-ds-update-password.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ recommendations: false
1010
---
1111

1212
# Update the password of your storage account identity in AD DS
13-
When you domain join your storage account in your Active Directory Domain Services (AD DS), you create an AD principal, usually either a computer or service account, with a password. The password of the AD principal is one of the Kerberos keys of the storage account. Depending on the password policy of the organization unit of the AD principal, you must periodically rotate the password of the AD principal to avoid authentication issues. Failing to change the password before it expires could result in losing Kerberos authentication to your Azure file shares. Some AD environments may also delete of the AD principals with expired passwords using automated cleanup.
13+
When you domain join your storage account in your Active Directory Domain Services (AD DS), you create an AD principal, either a computer account or service account, with a password. The password of the AD principal is one of the Kerberos keys of the storage account. Depending on the password policy of the organization unit of the AD principal, you must periodically rotate the password of the AD principal to avoid authentication issues. Failing to change the password before it expires could result in losing Kerberos authentication to your Azure file shares. Some AD environments may also delete of the AD principals with expired passwords using automated cleanup.
1414

15-
Instead of periodically rotating the password, you can also place the AD principal that represents the storage account into a dedicated organizational unit that has password rotation policies disabled using Group Policy.
15+
Instead of periodically rotating the password, you can also place the AD principal that represents the storage account into an organizational unit that does not require password rotation.
1616

1717
There are two options for triggering password rotation. You can use the `AzFilesHybrid` module or Active Directory PowerShell. Use one method, not both.
1818

@@ -32,7 +32,7 @@ There are two options for triggering password rotation. You can use the `AzFiles
3232

3333
## Option 1: Use AzFilesHybrid module
3434

35-
You can run the `Update-AzStorageAccountADObjectPassword` cmdlet from the [AzFilesHybrid module](https://github.com/Azure-Samples/azure-files-samples/releases). You must run this command in an on-premises AD DS-joined environment by a [hybrid identity](../../active-directory/hybrid/whatis-hybrid-identity.md) with owner permission to the storage account and AD DS permissions to change the password of the identity representing the storage account. The command performs actions similar to storage account key rotation. Specifically, it regenerates the second Kerberos key of the storage account and then uses it to update the password of the registered account in AD DS.
35+
You can run the `Update-AzStorageAccountADObjectPassword` cmdlet from the [AzFilesHybrid module](https://github.com/Azure-Samples/azure-files-samples/releases). You must run this command in an on-premises AD DS-joined environment by a [hybrid identity](../../active-directory/hybrid/whatis-hybrid-identity.md) with owner permission to the storage account and AD DS permissions to change the password of the identity that represents the storage account. The command performs actions similar to storage account key rotation. Specifically, it regenerates the second Kerberos key of the storage account and then uses it to update the password of the registered account in AD DS.
3636

3737
```PowerShell
3838
# Update the password of the AD DS account registered for the storage account
@@ -43,7 +43,7 @@ Update-AzStorageAccountADObjectPassword `
4343
-StorageAccountName "<your-storage-account-name-here>"
4444
```
4545

46-
After you rotate to kerb2, we recommend waiting several hours and using `Update-AzStorageAccountADObjectPassword` cmdlet again regenerate and rotate back to kerb1, such that both Kerberos keys have been regenerated.
46+
After you rotate to kerb2, we recommend waiting several hours and using `Update-AzStorageAccountADObjectPassword` cmdlet again regenerate and rotate back to kerb1, such that both Kerberos keys are regenerated.
4747

4848
## Option 2: Use Active Directory PowerShell
4949

@@ -52,7 +52,7 @@ If you don't want to download the `AzFilesHybrid` module, you can use [Active Di
5252
> [!IMPORTANT]
5353
> The Windows Server Active Directory PowerShell cmdlets in this section must be run in Windows PowerShell 5.1 with elevated privileges.
5454
55-
Replace `<domain-object-identity>` in the following script with your value, then run the script to update your domain object password:
55+
Replace `<domain-object-identity>` in the following script with the appropriate value for your environment:
5656

5757
```powershell
5858
$KeyName = "kerb1" # Could be either the first or second kerberos key, this script assumes we're refreshing the first
@@ -65,7 +65,7 @@ Set-ADAccountPassword -Identity <domain-object-identity> -Reset -NewPassword $Ne
6565

6666
## Test that the AD DS account password matches a Kerberos key
6767

68-
Now that you've updated the AD DS account password, you can test it using the following PowerShell command.
68+
After you update the AD DS account password, you can test it using the following PowerShell command.
6969

7070
```powershell
7171
Test-AzStorageAccountADObjectPasswordIsKerbKey -ResourceGroupName "<your-resource-group-name>" -Name "<your-storage-account-name>" -Verbose

0 commit comments

Comments
 (0)