PowerShell module overview

This topic introduces PowerShell cmdlets that you can use to manage and administer your directory via Adaxes.

PowerShell module cmdlets

You can use Adaxes PowerShell module cmdlets to perform various administrative, configuration, and diagnostic tasks. You can use the module to manage users, computers, groups and organizational units (OUs) in all the domains managed by Adaxes.

The following table lists all the cmdlets that are available in Adaxes PowerShell module.

To get a list of all cmdlets contained in the Adaxes PowerShell module, you can use the Get-Command -Module Adaxes command. For more information about any of the module cmdlets, use the Get-Help <cmdlet name> cmdlet, where <cmdlet name> is the name of the cmdlet that you want to research. For more detailed information, you can run any of the following cmdlets:

• Get-Help <cmdlet name> -Full
• Get-Help <cmdlet name> -Detailed
• Get-Help <cmdlet name> -Examples

Operations on directory objects can be performed either via the Adaxes service, or by directly accessing Active Directory domain controllers. When using the Adaxes Service as a proxy, you benefit from Adaxes features like Active Directory automation, workflow rules, data validation policies, audit and reporting. If you want an operation to be performed via the Adaxes Service, you need to specify the AdaxesService parameter for a cmdlet:

Enable-AdmAccount -Identity johnSmith -AdaxesService localhost

Active Directory module provider

You can use the Adaxes Active Directory module provider to easily navigate and access data that is stored in Active Directory. The Active Directory module provider exposes the Active Directory database through a hierarchical navigation system, which is very similar to the file system. For example, while you are using the module, you can use the following commands to navigate through Active Directory:

• cd
• dir
• remove
• .
• ..

You can use the Active Directory module provider to map Active Directory domains to specific provider drives. When the Active Directory module is first loaded, a default Active Directory drive (Adaxes:) is mounted. To connect to that drive, run the cd Adaxes: command. To connect a new drive to an Active Directory domain, use the following cmdlet:

New-PSDrive -Name <name of the drive> -PSProvider AdaxesActiveDirectory
    -Root "Adaxes:/[<Adaxes service host>/[<domain (NetBIOS/FQDN)>[<base DN>]]]"
    -Credential <domain name>\<username>

Example

New-PSDrive -Name "MyDrive" -PSProvider AdaxesActiveDirectory `
    -Root "Adaxes:/adaxeshost.company.com/domain.com/CN=Users,DC=domain,DC=com"

See also

• Writing ADSI scripts
• Server-side scripting

---