0% found this document useful (0 votes)
66 views2 pages

PowerShell Script for ACTT on Windows

This document provides instructions for executing the ACTT PowerShell script on Windows Server to extract Active Directory or local configuration data. It outlines prerequisites, including necessary privileges and PowerShell version, and details the steps to run the script and share the output with Deloitte. The script is read-only and does not modify server configurations, and users are advised to follow their company's change management policies.
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
66 views2 pages

PowerShell Script for ACTT on Windows

This document provides instructions for executing the ACTT PowerShell script on Windows Server to extract Active Directory or local configuration data. It outlines prerequisites, including necessary privileges and PowerShell version, and details the steps to run the script and share the output with Deloitte. The script is read-only and does not modify server configurations, and users are advised to follow their company's change management policies.
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd

Automated Controls Testing Tool

Instruction Document
Execute the PowerShell Script for Windows Server (Domain Controller and Local
Server):
This document contains the instructions to execute the ACTT PowerShell script for Windows, which will
read the relevant data from the Windows Server and produce “. actt” files that can be zipped and sent
to Deloitte.

The PowerShell script has read only commands and does not modify the server configuration.

Prerequisites for executing the ACTT PowerShell script for Windows:


The “ACTT_WINDOWS_Script.ps1” file is required along with this instruction document. The script auto
detects the environment and extracts Active Directory information if the server is Domain Controller
(DC)else extracts the Local configuration information if it’s a Local server (NDC).

To execute the script the following privileges are required:

1. Administrator Privileges, i.e., Domain Admins (for Domain Controllers).


2. Administrator Privileges, i.e., Local Administrator (for Non Domain Controllers/Local Servers).
3. PowerShell version on your server needs to be version 4.0 and above.

PowerShell Execution policy needs to be set to RemoteSigned. The below command needs to be run on
PowerShell prompt prior to executing the ACTT script on the server and this setting affects only the
current Windows PowerShell session.

Set-ExecutionPolicy RemoteSigned -Scope Process

Technical Specifications:

Operating System: Windows Server 2008/R2 Or 2012/R2 Or 2016

PowerShell Versions: 4.0 and above


Not Compatible with: PowerShell versions 3.0 and below
Type of
Program/Query: Windows PowerShell

OS Content Extraction Guide for Operating System: Windows Server


Last updated April 25, 2022
Automated Controls Testing Tool

Steps for executing the PowerShell script (DC and NDC):


1. Identify the environment and the type of extraction you need for audit. If you require Active
Directory information, please use the script on a Domain Controller (DC) server. If you would like
to extract Local server configuration, please use the script on a Local Server (NDC)
2. Place the script in an empty folder on the server. Make sure that the server has enough storage
space available (Around 2 GB minimum).
3. Open PowerShell prompt as ‘Administrator’ Or as a user who has Domain Admin rights and
change directory to the folder where the script resides. Run the script with below command.
.\<ScriptName>

4. The script will not prompt for credentials. It will take the credentials of the currently logged in
user or the user who had opened the PowerShell prompt. Hence please make sure that you are
logged in as a Domain Admin(If running on DC) or as Administrator (If executing on NDC).
5. Post extraction you will see a new folder created with extracted files on the same folder where
the script was executed. Please Zip the folder and share it with Deloitte contact.

Notice:

The purpose of this “read only” script is to download data that can be analyzed as part of our audit. We
expect that you will follow your company’s regular change management policies and procedures prior to
running the script.

To the extent permitted by law, regulation and our professional standards, this script is provided “as is,”
without any warranty, and the Deloitte Network and its contractors will not be liable for any damages
relating to this script or its use. As used herein, “we” and “our” refers to the Deloitte Network entity
that provided the script to you, and the “Deloitte Network” refers to Deloitte Touche Tohmatsu Limited
(“DTTL”), the member firms of DTTL, and each of their affiliates and related entities.

© 2022. For more information, contact Deloitte Touche Tohmatsu Limited. All rights reserved.

OS Content Extraction Guide for Operating System: Windows Server


Last updated April 25, 2022

Common questions

Powered by AI

If the PowerShell ExecutionPolicy is not set to RemoteSigned, the script may not execute due to default security settings in PowerShell that prevent running scripts downloaded from the internet. This could impede the data extraction process, as the policy is crucial for ensuring that scripts executed have a trusted digital signature. The requirement to set ExecutionPolicy to RemoteSigned ensures that remotely sourced scripts are verified before execution .

Insufficient storage space on the server during the execution of the ACTT script could significantly impact the script's ability to operate as designed. The script requires around 2 GB of free space, a critical need for accommodating output files post-data extraction. Lack of adequate space may lead to script failure, incomplete file generation, or even disrupt server operations if existing services need that space to run effectively .

The instruction document ensures that no server modifications occur during the script execution by specifically noting the script contains only 'read-only' commands. It emphasizes that the script does not alter server configurations, reassuring users that data extraction is done safely without affecting server operations .

To successfully execute the ACTT PowerShell script on a Windows Server, the following prerequisites must be met: an "ACTT_WINDOWS_Script.ps1" file, administrator privileges pertinent to the server type (Domain Admins for Domain Controllers and Local Administrator for Non-Domain Controllers/Local Servers), PowerShell version 4.0 or above installed, and the PowerShell Execution policy set to RemoteSigned specifically for the session .

The ACTT PowerShell script is compatible only with PowerShell versions 4.0 and above. It is not compatible with PowerShell version 3.0 or lower. This limitation is likely due to the script's dependence on features and cmdlets available only in the more recent PowerShell versions, thus requiring users to update their PowerShell environment if necessary to run the script .

The directory where the ACTT script file needs to reside serves as the execution environment for the script. By placing the script in an empty folder with sufficient storage space (around 2 GB), it ensures that there is an organized location for the output files to be stored post-execution. This setup prevents data overwrite or loss by isolating the execution process and its outputs .

After the ACTT script execution and data extraction, users will find a new folder created with the extracted files in the directory where the script was executed. The next step is to zip the folder containing the extracted files and share it with the Deloitte contact as part of the data analysis audit process .

Having Domain Admin or Local Admin rights is crucial because the script needs the appropriate permissions to access and extract detailed system and Active Directory information. Without the necessary administrative rights, the script may fail to execute or result in incomplete data extraction, leading to insufficient data for audit purposes .

The ACTT PowerShell script auto-detects the environment in which it is executed. If the script is run on a Domain Controller (DC), it extracts Active Directory information, whereas if it is run on a Local Server, it extracts the local server configuration. This functionality allows it to tailor the data extraction process based on the server type .

The potential risks associated with the ACTT script include the lack of warranty and disclaimers of liability for any damages resulting from the use of the script, as stated in the instructions. Users are also obliged to follow their company's regular change management policies when using the script. This indicates that while the script is provided 'as is,' responsibility for any negative outcomes or damages rests with the user or their organization, not the Deloitte Network .

You might also like