User and group management in Amazon Managed Microsoft AD
You can manage users and groups in Amazon Managed Microsoft AD. You create a user to represent a person or entity that can access your directory. You can also create a group to grant and deny permissions to more than one user at a time. You can add not only users to a group, but also groups to a group. When you add a user to a group, the user inherits the roles and permissions assigned to the group. When you add a group to a group, the groups share a parent-child relationship, where the child group inherits the roles and permissions assigned to the parent group. You can also copy a user's group memberships into another user.
You can manage users and groups with Amazon Directory Service Data using the following methods:
For a demonstration of the Amazon Directory Service Data CLI, see the following YouTube video.
Alternatively, you can use a domain-joined instance.
Manage users and groups with the Amazon Web Services Management Console
You can manage users and groups with the Amazon Web Services Management Console with Amazon Directory Service Data. Directory Service Data is an extension of Amazon Directory Service that provides you with the ability to perform built-in object management tasks. Some of these tasks include creating users and groups and adding users to groups as well as groups to a group.
For more information, see Manage Amazon Managed Microsoft AD users and groups with the Amazon Web Services Management Console.
Note
To use this feature, it must be enabled. For more information, see Enable user and group management.
You can only manage users and groups with the Amazon Web Services Management Console from the Primary Amazon Web Services Region for your directory. For more information, see Primary vs additional Regions.
You'll need the necessary IAM permissions to use Amazon Directory Service Data. For more information, see Amazon Directory Service API permissions: Actions, resources, and conditions reference. To get started granting permissions to your users and workloads, you can use Amazon managed policies like AWSDirectoryServiceDataFullAccess or AWSDirectoryServiceDataReadOnlyAccess. For more information, see Security best practices in IAM.
Manage users and groups with the Amazon CLI
You can manage users and groups with the Amazon CLI through the Amazon Directory Service Data
API. Directory Service Data is an extension of Amazon Directory Service that provides you with the ability to perform
built-in object management tasks using the ds-data
namespace. Some of these tasks
include creating users and groups and adding users to groups as well as groups to a
group.
Create a user with Amazon Directory Service Data CLI
The following is an example Amazon CLI command that uses the ds-data
namespace
to create a user.
aws ds-data create-user --directory-id
d-1234567890
--sam-account-name"jane.doe"
--regionyour-Primary-Region-name
Note
To use this Amazon CLI, it must be enabled. For more information, see Enabling or disabling user and group management or Amazon Directory Service Data.
You can only manage users and groups with the Amazon Directory Service Data CLI from the primary Amazon Web Services Region for your directory. For more information, see Primary vs additional Regions.
You'll need the necessary IAM permissions to use Amazon Directory Service Data. For more information, see Amazon Directory Service API permissions: Actions, resources, and conditions reference. To get started granting permissions to your users and workloads, you can use Amazon managed policies like. AWSDirectoryServiceDataFullAccess or AWSDirectoryServiceDataReadOnlyAccess. For more information, see Security best practices in IAM
For more information, see Manage Amazon Managed Microsoft AD users and groups with the Amazon CLI.
Manage users and groups with Amazon Tools for PowerShell
The Amazon Tools for PowerShell provides two separate modules for managing Amazon Directory Service:
AWS.Tools.DirectoryService
(DS) and AWS.Tools.DirectoryServiceData
(DSD). When working with Amazon Directory Service, ensure you're using the appropriate module for your
intended operation.
-
The
DirectoryService
module contains cmdlets for managing directory service configuration and administration, including cmdlets likeEnable-DSDirectoryDataAccess
,Disable-DSDirectoryDataAccess
, andReset-DSUserPassword
. -
The
DirectoryServiceData
module contains cmdlets for performing operations within a directory, specifically focused on user and group management. These DSD cmdlets include user management operations (New-DSDUser
,Get-DSDUser
,Update-DSDUser
, andRemove-DSDUser
), group management operations (New-DSDGroup
,Get-DSDGroup
, andUpdate-DSDGroup
,Remove-DSDGroup
), group membership management (Add-DSDGroupMember
, andRemove-DSDGroupMember
), and search functionality (Search-DSDUser
andSearch-DSDGroup
).
Manage users and groups with an on-premise instance or Amazon EC2 instance
If the Amazon Directory Service Data doesn't support your use case, we recommend managing users and groups with an on-premise or EC2 instance.
To create users and groups in an Amazon Managed Microsoft AD, you can use any instance (from either on-premises or EC2) that has been joined to your Amazon Managed Microsoft AD. You need to be logged in as a user that has privileges to create users and groups. You will also need to install the Active Directory Tools on your instance so you can add your users and groups with the Active Directory Users and Computers tool.
-
You can deploy a pre-configured EC2 instance with preinstalled Active Directory administrative tools from Amazon Directory Service management console. For more information, see Launching a directory administration instance in your Amazon Managed Microsoft AD Active Directory.
-
If you need to deploy a self-managed EC2 instance with administrative tools and install the necessary tools, see Step 3: Deploy an Amazon EC2 instance to manage your Amazon Managed Microsoft AD Active Directory.