Chat now with support
Chat with Support

Change Auditor 7.3 - PowerShell User Guide

PowerShell Commands

Adding the PowerShell module

Viewing available commands and help

Installing Change Auditor coordinators and web clients

Setting the master time zone

Finding Change Auditor installations and coordinators

Connecting to and disconnecting from Change Auditor installations and coordinators

Managing client authentication options

Gathering Change Auditor system information

Deploying Change Auditor agents

Managing auditing templates

Working with searches

Managing Active Directory Database auditing

Working with Active Directory Database protection templates

Managing Windows File System auditing

Managing SQL Extended Events Auditing (Preview)

Managing Fluid File System auditing

Managing Azure Active Directory auditing

Managing Office 365 auditing

Managing Skype for Business auditing

Configuring a Quest On Demand Audit integration

Working with Active Directory protection templates

 

Adding the PowerShell module

Change Auditor comes with a PowerShell module for you to use to manage your environment. It is installed when you install the Windows client or a coordinator.

* 
NOTE: Windows PowerShell version 3.0 or higher is required.
To import the Change Auditor PowerShell module:
1
Open a Windows PowerShell window and type the following at the Windows PowerShell command prompt:
Import-Module <path>
Where "<path>" is the file path for the ChangeAuditor.PowerShell.dll assembly found in the Change Auditor Windows client or Change Auditor coordinator folder.
2
To ensure that the module was added, type the following at the Windows PowerShell command prompt:
Get-Module -All
The registered PowerShell modules are listed.

Viewing available commands and help

•
To view all available Change Auditor commands, enter:
Get-Command -Module ChangeAuditor.PowerShell
•
To view help on each command including the syntax, enter:
Get-Help cmdletName
•
To view an interactive command browser that shows you the layout of commands and the help for the commands, enter:
Show-Command cmdletName

 

* 
NOTE: Sample scripts are available in the Change Auditor client folder. By default they are located here: C:\Program Files\Quest\ChangeAuditor\Client\PowerShell Sample Scripts

Installing Change Auditor coordinators and web clients

The following commands allow you to install Change Auditor components.

•
Install-CACoordinator
•
Install-CAWebClient
•
Install-CALicense
Install-CACoordinator

Use this command to install locally a Change Auditor Coordinator.

Table 1. Available parameters
Parameter
Description

-MsiPath

The location to find the coordinator MSI file. The coordinator is installed using this installer.

-SQLAuthDatabaseCredential

Credentials to use for the coordinator to access the SQL Server. Specify when the coordinator should use SQL Authentication mode.

NOTE: For Azure SQL Managed Instance (PaaS), SQL Authentication

Database Credential or Azure Active Directory Credential must be used. The Encrypt connection option will be enabled by default.

-AzureADAuthDatabaseCredential

Credentials to use for the coordinator to access the SQL Server. Specify when the coordinator should use Azure Active Directory authentication mode.

NOTE: For Azure SQL Managed Instance (PaaS), SQL Authentication Database Credential or Azure Active Directory Credential must be used. The Encrypt connection option will be enabled by default.

-DatabaseCredential

Credentials to use for the coordinator to access the SQL Server. Specify when the coordinator should use Windows Authentication mode. These credentials must be a valid set of Windows credentials..

-DatabaseServer

The SQL Server to host the database.

-LogPath

The local path on the computer where the installation log is written.

-AgentPort (Optional)

The static port for Change Auditor 6.x agents to communicate with the coordinator.

-ClientPort (Optional)

 

The static port for the Change Auditor client to communicate with the coordinator.

-DatabaseName (Optional)

The name assign to the Change Auditor database.

-InstallationName (Optional)

Name that uniquely identifies the current Change Auditor installation within your Active Directory environment.

If this is an additional coordinator in an existing installation (sharing the same database), ensure that you use the name of the existing installation.

-LegacyAgentPort (Optional)

 

The static port for legacy (5.x) Change Auditor agents to communicate with the coordinator.

-SDKPort (Optional)

The static port used by external applications to access the coordinator

Example: Perform a local installation of a Change Auditor coordinator

Install-CACoordinator -MsiPath "C:\Users\Administrator\Desktop\Quest Change Auditor Coordinator 6 (x64).msi" -SQLAuthDatabaseCredential $dbcredential -DatabaseServer "MyDatabase" -LogPath "C:\Users\Administrator\Desktop\Coordinator.log"

After running this command, the installed coordinator will have the installation name “DEFAULT” and look for or create a database named ChangeAuditor.

Install-CAWebClient

Use this command to install locally the web client.

 

Table 2. Available parameters
Parameter
Description

-LogPath

The local path on the computer where the installation log is written.

-MsiPath

The location to find the web client MSI file. The web client is installed using this installer.

-CoordinatorConnection (Optional)

 

A previously created connection from Connect-CAClient.

-SiteName (Optional)

The web site name for the Change Auditor web client.

-SitePort (Optional)

A unique port for the web site to avoid conflicts with other IIS applications (for example, SharePoint® uses the default port 80; therefore, the IIS web site for the Change Auditor web client must use a different port). If a conflicting port is specified, attempting to launch the web client displays either an ‘HTTP 404 Not Found’ or ‘Page cannot be displayed’ error.

Example: Install a web client

Install-CAWebClient -MsiPath "C:\Users\Administrator\Desktop\Quest Change Auditor Web Client 6 (x64).msi" -CoordinatorConnection $connection -LogPath "C:\Users\Administrator\Desktop\WebClientInstallationLog.log"

Install-CALicense

Use this command to install licenses to the coordinators in a Change Auditor installation.

 

Table 3. Available parameters
Parameter
Description

-Connection

A connection obtained by using the Connect-CAClient command.

-LicensePath

The license file directory on the client computer.

-Coordinator (Optional)

The single coordinator where you want to install the license (rather than all coordinators).

-Certificate (Optional)

The thumbprint of a client authentication certificate to use instead of automatically searching the current user's personal certificate store.

Example: Install a Change Auditor license in Installation domain, when using certificate authentication

$creds = Get-Credential

$connection = Connect-CAClient -credential $creds

$coordinatorToLicense = Get-CACoordinators -Connection $connection

Install-CALicense $connection –LicensePath 'c:\ChangeAuditor.dlv'

Example: Install license to single coordinator in the Installation which is installed on the local system, when using certificate authentication

$creds = Get-Credential

$connection = Connect-CAClient -SelectLocalCoordinator -credential $creds

$coordinatorToLicense = Get-CACoordinator -Connection $connection

Install-CALicense -Connection $connection -Coordinator $coordinatorToLicense –LicensePath 'c:\ChangeAuditor.dlv'

Example: Install a Change Auditor for Active Directory license

Install-CALicense $connection –LicensePath C:\7_0_AD_license_PER.dlv

Example: Install license to single coordinator in the Installation which is installed on the local system

$connection = Connect-CAClient -SelectLocalCoordinator

$coordinatorToLicense = Get-CACoordinator -Connection $connection

Install-CALicense -Connection $connection -Coordinator $coordinatorToLicense -LicensePath 'c:\7_0_AD_license_PER.dlv'

 

* 
NOTE: Optional Coordinator parameter object must be obtained using Get-CACoordinator command.
Self Service Tools
Knowledge Base
Notifications & Alerts
Product Support
Software Downloads
Technical Documentation
User Forums
Video Tutorials
RSS Feed
Contact Us
Licensing Assistance
Technical Support
View All

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating