---
title: arpio-config:fsx:ad:OrganizationalUnitDistinguishedName
description: Use a custom value for OrganizationalUnitDistinguishedName when an FSx for Windows file system is recovered
---

[Skip to content](https://docs.arpio.io/arpio-organizationalunitdistinguishedname#main-content)

English

Show submenu for translations

[Customer ticket portal](https://docs.arpio.io/tickets-view?hsLang=en)

- Home
- Products
- Pricing
- Blog
- Company

Open main navigation

Close main navigation

- Home
- Products
- Pricing
- Blog
- Company
- English
  
  Show submenu for translations
- [Customer ticket portal](https://docs.arpio.io/tickets-view)

 Welcome to Arpio Technical Docs

- There are no suggestions because the search field is empty.

1. [Arpio Documentation](https://docs.arpio.io/?hsLang=en)
2. [AWS Reference Guides](https://docs.arpio.io/aws-reference-guides?hsLang=en)
3. [AWS Configuration Tags](https://docs.arpio.io/aws-reference-guides?hsLang=en#aws-configuration-tags)

# arpio-config:fsx:ad:OrganizationalUnitDistinguishedName

## Use a custom value for OrganizationalUnitDistinguishedName when an FSx for Windows file system is recovered

```
arpio-config:fsx:ad:OrganizationalUnitDistinguishedName = <tag-safe-distinguished-name>
```

#### <tag-safe-distinguished-name>

The value to use for the OrganizationalUnitDistinguishedName property of the [SelfManagedActiveDirectoryAttributes](https://docs.aws.amazon.com/fsx/latest/APIReference/API_SelfManagedActiveDirectoryAttributes.html) structure used to recover an FSx for Windows file system that uses a self-managed Active Directory, with colon characters used in place of comma characters.

FSx does not permit comma characters in tag values, so colon characters must be used in place of commas in the distinguished name value you specify.

If the value is empty, Arpio will not send a value for OrganizationalUnitDistinguishedName to AWS when recovering the file system, which causes FSx to use the default organizational unit.

### Supported Resources

- FSx for Windows file systems (self-managed Active Directory only)

### Description

When recovering an FSx for Windows file system with self-managed Active Directory settings, Arpio normally uses the OrganizationalUnitDistinguishedName value read from the primary environment.  Sometimes you may need to use a different value in the recovery environment, for example, because the organizational unit that was originally used is no longer present in the directory, or should no longer be used for this purpose for some other reason.

You can use this config tag to specify a different value to use for OrganizationalUnitDistinguishedName when Arpio recovers the tagged filesystem.  This tag only works for file systems configured to use a self-managed Active Directory.  It will be ignored for other FSx file system types.

If you use an empty value for this tag, Arpio will send no value for the OrganizationalUnitDistinguishedName property when it recovers the filesystem.  This causes the FSx service to use a default value.

### Examples

| Tag | Value |
| --- | --- |
| ``` arpio-config:fsx:ad:OrganizationalUnitDistinguishedName ``` | OU=FSx:DC=storage:DC=example:DC=com |
| ``` arpio-config:fsx:ad:OrganizationalUnitDistinguishedName ``` |   |

The first example tells Arpio to recover the filesystem using `OU=FSx,DC=storage,DC=example,DC=com` as the new organizational unit's distinguished name.  Arpio converts colon characters in the tag value to comma characters before it sends the OU value to the FSx API during recovery.

The second example uses an empty tag value, which causes Arpio to send no value for the OrganizationalUnitDistinguishedName property when it recovers the filesystem.  This causes the FSx service to use its default organizational unit.

 

- [Getting Started](https://docs.arpio.io/getting-started?hsLang=en#main-content)
  
  
  
  
  
    - [New Account Setup](https://docs.arpio.io/getting-started?hsLang=en#new-account-setup)
    - [New Application Setup](https://docs.arpio.io/getting-started?hsLang=en#new-application-setup)
- [Arpio Fundamentals](https://docs.arpio.io/arpio-fundamentals?hsLang=en#main-content)
  
  
  
  
  
    - [Platform Fundamentals](https://docs.arpio.io/arpio-fundamentals?hsLang=en#platform-fundamentals)
    - [Platform Features](https://docs.arpio.io/arpio-fundamentals?hsLang=en#platform-features)
- [Arpio Reference Guides](https://docs.arpio.io/arpio-reference-guides?hsLang=en#main-content)
  
  
  
  
  
    - [Arpio API](https://docs.arpio.io/arpio-reference-guides?hsLang=en#arpio-api)
    - [Lifecycle Events](https://docs.arpio.io/arpio-reference-guides?hsLang=en#lifecycle-events)
    - [Role-Based Access Controls (RBAC)](https://docs.arpio.io/arpio-reference-guides?hsLang=en#role-based-access-controls-rbac)
    - [Single Sign-On (SSO) Integration](https://docs.arpio.io/arpio-reference-guides?hsLang=en#single-sign-on-sso-integration)
    - [Test Planning](https://docs.arpio.io/arpio-reference-guides?hsLang=en#test-planning)
    - [Test & Recovery How-To](https://docs.arpio.io/arpio-reference-guides?hsLang=en#test-recovery-how-to)
- [AWS Reference Guides](https://docs.arpio.io/aws-reference-guides?hsLang=en#main-content)
  
  
  
  
  
    - [AWS Resource Reference](https://docs.arpio.io/aws-reference-guides?hsLang=en#aws-resource-reference)
    - [AWS Configuration Tags](https://docs.arpio.io/aws-reference-guides?hsLang=en#aws-configuration-tags)
    - [AWS Access](https://docs.arpio.io/aws-reference-guides?hsLang=en#aws-access)
    - [AWS Testing](https://docs.arpio.io/aws-reference-guides?hsLang=en#aws-testing)
    - [AWS Solutions](https://docs.arpio.io/aws-reference-guides?hsLang=en#aws-solutions)
- [Azure Reference Guides](https://docs.arpio.io/azure-reference-guides?hsLang=en#main-content)
  
  
  
  
  
    - [Azure Resource Reference](https://docs.arpio.io/azure-reference-guides?hsLang=en#azure-resource-reference)
    - [Azure Configuration Tags](https://docs.arpio.io/azure-reference-guides?hsLang=en#azure-configuration-tags)
    - [Azure Scenarios](https://docs.arpio.io/azure-reference-guides?hsLang=en#azure-scenarios)
- [FAQ](https://docs.arpio.io/faq?hsLang=en#main-content)
  
  
  
  
  
    - [AWS FAQ](https://docs.arpio.io/faq?hsLang=en#aws-faq)
    - [Contact Support](https://docs.arpio.io/faq?hsLang=en#contact-support)
    - [License & Billing](https://docs.arpio.io/faq?hsLang=en#license-billing)
    - [Tests and Recoveries](https://docs.arpio.io/faq?hsLang=en#tests-and-recoveries)

- Home
- Products
- Pricing
- Blog
- Company

[![bubble-wand-tight.64](https://docs.arpio.io/hs-fs/hubfs/bubble-wand-tight.64.png?width=64&height=64&name=bubble-wand-tight.64.png "bubble-wand-tight.64")](https://arpio.io)

Copyright © 2026, Arpio