AsBuiltReport is a PowerShell module which generates As-Built documentation for many common datacentre infrastructure systems. Reports can be generated in Text, XML, HTML and MS Word formats and can be presented with custom styling to align with your company/customer's brand. The following systems are currently fully supported, with many more being added very shortly:
The following simple list of instructions will get you started with the AsBuiltReport module.
All CmdLets and Functions require the PScribo module version 0.7.24 or later. PScribo can be installed from the PowerShell Gallery with the following command.
Each of the specific As-Built report types may also require other modules or PSSnapins.
The pre-requisites for each report type will be documented within its own
README.md located in the
Clone this repository with the following command.
git clone https://github.com/tpcarman/As-Built-Report.git
Change directory into the cloned repository and import the module manifest.
cd .\As-Built-Report Import-Module .\AsBuiltReport.psd1
Each report type utilises a common set of parameters. Additional parameters specific to each
report will be detailed in the report's
README.md file, along with any relevant examples.
Each report type has its own sub-directory, within the
For a full list of common parameters and examples you can view the
New-AsBuiltReport CmdLet help with the following command.
Get-Help New-AsBuiltReport -Full
Here are some examples to get you going.
# The following creates a VMware vSphere As-Built report in HTML & Word formats. # The document will highlight particular issues which exist within the environment by including the Healthchecks switch. PS C:\>New-AsBuiltReport -Target 192.168.1.100 -Username admin -Password admin -Format HTML,Word -Type vSphere -Healthchecks # The following creates a Pure Storage FlashArray As-Built report in Text format and appends a timestamp to the filename. It also uses stored credentials to connect to the system. PS C:\>$Creds = Get-Credential PS C:\>New-AsBuiltReport -Target 192.168.1.100 -Credentials $Creds -Format Text -Type FlashArray -Timestamp # The following creates a Cisco UCS As-Built report in default format (Word) with a customised style. PS C:\>New-AsBuiltReport -IP 192.168.1.100 -Username admin -Password admin -Type UCS -StyleName ACME # The following creates a VMware vSphere As-Built report in HTML format, using the configuration in the asbuilt.json file located in the C:\scripts\ folder. PS C:\>New-AsBuiltReport -IP 192.168.1.100 -Username admin -Password admin -Format HTML -Type vSphere -AsBuiltConfigPath C:\scripts\asbuilt.json
VMware NSX-V As Built Report
- Information relating to the VMware NSX-V As-Built Report can be found in the report's README.md
VMware vSphere As Built Report
- Information relating to the VMware vSphere As-Built Report can be found in the report's README.md
[0.3.0] - Unreleased
- This minor version contains a complete refactor of the project so that it is now a PowerShell module.
- We will now aim to host this module on PSGallery in the near future to allow for easier installation and usage.
[0.2.1] - 2018-09-19
- Added parameter validation to
Targetparameter to accept multiple IP/FQDN
- Fixed issues with CWD paths
- Updated default JSON configuration filename to align with documentation
[0.2.0] - 2018-08-13
- New As Built JSON configuration structure
- allows unique configuration files to be created and saved
AsBuiltConfigPathparameter is not specified, user is prompted for As Built report configuration information
Config.jsonfiles are no longer required
Table Of Contents (TOC) may be missing in Word formatted report
When opening the DOC report, MS Word prompts the following
"This document contains fields that may refer to other files. Do you want to update the fields in this document?"
Yes / No
Nowill prevent the TOC fields being updated and leaving the TOC empty.
Yesto this message when prompted by MS Word.
In HTML documents, word-wrap of table cell contents is not working, causing the following issues;
- Cell contents may overflow table columns
- Tables may overflow page margin
- PScribo Issue #83
In Word documents, some tables are not sized proportionately. To prevent cell overflow issues in HTML documents, most tables are auto-sized, this causes some tables to be out of proportion.