Skip to content

Commit 9537625

Browse files
committed
Update documentation for clarity and consistency
1 parent c5272e1 commit 9537625

File tree

1 file changed

+49
-45
lines changed

1 file changed

+49
-45
lines changed

README.md

Lines changed: 49 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<!-- ********** DO NOT EDIT THESE LINKS ********** -->
22
<p align="center">
33
<a href="https://www.asbuiltreport.com/" alt="AsBuiltReport"></a>
4-
<img src='https://avatars.githubusercontent.com/u/42958564' width="8%" height="8%" /></a>
4+
<img src='https://avatars.githubusercontent.com/u/42958564' width="8%" height="8%" /></a>
55
</p>
66
<p align="center">
77
<a href="https://www.powershellgallery.com/packages/AsBuiltReport.Veeam.VB365/" alt="PowerShell Gallery Version">
@@ -21,21 +21,20 @@
2121
</p>
2222
<p align="center">
2323
<a href="https://twitter.com/AsBuiltReport" alt="Twitter">
24-
<img src="https://img.shields.io/twitter/follow/AsBuiltReport.svg?style=social"/></a>
24+
<img src="https://img.shields.io/twitter/follow/AsBuiltReport.svg?style=social"/></a>
2525
</p>
2626
<!-- ********** DO NOT EDIT THESE LINKS ********** -->
2727

2828
> [!WARNING]
29-
> I recently made the decision to not apply to the Veeam Vanguard program which was one of the main reasons for developing and maintaining this project. For this reason I will not be maintaining or updating this report. At this time until someone is identified to maintain the project, this report will be frozen in terms of new capabilities.
30-
>
31-
#### This project is community maintained and has no sponsorship from Veeam, its employees or any of its affiliates.
29+
> I recently decided not to apply to the Veeam Vanguard program, which was one of the main reasons for developing and maintaining this project. Therefore, I will not be maintaining or updating this report. Until someone is identified to maintain the project, this report will be frozen in terms of new capabilities.
3230
31+
#### This project is community maintained and has no sponsorship from Veeam, its employees, or any of its affiliates.
3332

3433
# Veeam VB365 As Built Report
3534

36-
Veeam VB365 As Built Report is a PowerShell module which works in conjunction with [AsBuiltReport.Core](https://github.com/AsBuiltReport/AsBuiltReport.Core).
35+
Veeam VB365 As Built Report is a PowerShell module that works in conjunction with [AsBuiltReport.Core](https://github.com/AsBuiltReport/AsBuiltReport.Core).
3736

38-
[AsBuiltReport](https://github.com/AsBuiltReport/AsBuiltReport) is an open-sourced community project which utilises PowerShell to produce as-built documentation in multiple document formats for multiple vendors and technologies.
37+
[AsBuiltReport](https://github.com/AsBuiltReport/AsBuiltReport) is an open-source community project that utilizes PowerShell to produce as-built documentation in multiple document formats for various vendors and technologies.
3938

4039
Please refer to the AsBuiltReport [website](https://www.asbuiltreport.com) for more detailed information about this project.
4140

@@ -52,24 +51,26 @@ Sample Veeam VB365 As Built report diagram file: [Sample Veeam VB365 As Built Re
5251
![Sample Diagram](Samples/AsBuiltReport.Veeam.VB365.png)
5352

5453
# :beginner: Getting Started
55-
Below are the instructions on how to install, configure and generate a Veeam VB365 As Built report.
54+
55+
Below are the instructions on how to install, configure, and generate a Veeam VB365 As Built report.
5656

5757
## :floppy_disk: Supported Versions
58-
<!-- ********** Update supported VB365 versions ********** -->
59-
The Veeam VB365 As Built Report supports the following Veeam Backup for Microsoft 365 version;
58+
59+
The Veeam VB365 As Built Report supports the following Veeam Backup for Microsoft 365 version:
6060

6161
- Veeam Backup for Microsoft 365 v6+
6262

6363
### PowerShell
64-
This report is compatible with the following PowerShell versions;
6564

66-
<!-- ********** Update supported PowerShell versions ********** -->
65+
This report is compatible with the following PowerShell versions:
66+
6767
| Windows PowerShell 5.1 | PowerShell 7 |
6868
| :--------------------: | :----------: |
6969
| :white_check_mark: | :x: |
70+
7071
## :wrench: System Requirements
71-
<!-- ********** Update system requirements ********** -->
72-
PowerShell 5.1, and the following PowerShell modules are required for generating a Veeam VB365 As Built Report.
72+
73+
PowerShell 5.1 and the following PowerShell modules are required for generating a Veeam VB365 As Built Report:
7374

7475
- [Veeam.Archiver.PowerShell Module](https://helpcenter.veeam.com/docs/vbo365/powershell/getting_started.html?ver=70)
7576
- [PScriboCharts Module](https://github.com/iainbrighton/PScriboCharts)
@@ -78,50 +79,52 @@ PowerShell 5.1, and the following PowerShell modules are required for generating
7879
- [AsBuiltReport.Veeam.VB365 Module](https://www.powershellgallery.com/packages/AsBuiltReport.Veeam.VB365/)
7980

8081
### :closed_lock_with_key: Required Privileges
81-
<!-- ********** Define required privileges ********** -->
82-
<!-- ********** Try to follow best practices to define least privileges ********** -->
83-
Only users with Local Administrator group permissions can generate a Veeam VB365 As Built Report.
8482

83+
Only users with Local Administrator group permissions can generate a Veeam VB365 As Built Report.
8584

8685
## :package: Module Installation
8786

8887
### PowerShell
89-
<!-- ********** Add installation for any additional PowerShell module(s) ********** -->
88+
9089
```powershell
91-
install-module AsBuiltReport.Veeam.VB365
90+
Install-Module AsBuiltReport.Veeam.VB365
9291
```
9392

9493
### GitHub
94+
9595
If you are unable to use the PowerShell Gallery, you can still install the module manually. Ensure you repeat the following steps for the [system requirements](https://github.com/AsBuiltReport/AsBuiltReport.Veeam.VB365#wrench-system-requirements) also.
9696

97-
1. Download the code package / [latest release](https://github.com/AsBuiltReport/AsBuiltReport.Veeam.VB365/releases/latest) zip from GitHub
98-
2. Extract the zip file
97+
1. Download the code package / [latest release](https://github.com/AsBuiltReport/AsBuiltReport.Veeam.VB365/releases/latest) zip from GitHub.
98+
2. Extract the zip file.
9999
3. Copy the folder `AsBuiltReport.Veeam.VB365` to a path that is set in `$env:PSModulePath`.
100-
4. Open a PowerShell terminal window and unblock the downloaded files with
100+
4. Open a PowerShell terminal window and unblock the downloaded files with:
101101
```powershell
102102
$path = (Get-Module -Name AsBuiltReport.Veeam.VB365 -ListAvailable).ModuleBase; Unblock-File -Path $path\*.psd1; Unblock-File -Path $path\Src\Public\*.ps1; Unblock-File -Path $path\Src\Private\*.ps1
103103
```
104104
5. Close and reopen the PowerShell terminal window.
105105
106-
_Note: You are not limited to installing the module to those example paths, you can add a new entry to the environment variable PSModulePath if you want to use another path._
106+
_Note: You are not limited to installing the module to those example paths; you can add a new entry to the environment variable PSModulePath if you want to use another path._
107107
108108
## :pencil2: Configuration
109109
110-
The Veeam VB365 As Built Report utilizes a JSON file to allow configuration of report information, options, detail and healthchecks.
110+
The Veeam VB365 As Built Report utilizes a JSON file to allow configuration of report information, options, detail, and health checks.
111+
112+
A Veeam VB365 report configuration file can be generated by executing the following command:
111113
112-
A Veeam VB365 report configuration file can be generated by executing the following command;
113114
```powershell
114115
New-AsBuiltReportConfig -Report Veeam.VB365 -FolderPath <User specified folder> -Filename <Optional>
115116
```
116117

117-
Executing this command will copy the default Veeam VB365 report JSON configuration to a user specified folder.
118+
Executing this command will copy the default Veeam VB365 report JSON configuration to a user-specified folder.
118119

119120
All report settings can then be configured via the JSON file.
120121

121-
The following provides information of how to configure each schema within the report's JSON file.
122+
The following provides information on how to configure each schema within the report's JSON file.
122123

123124
<!-- ********** DO NOT CHANGE THE REPORT SCHEMA SETTINGS ********** -->
125+
124126
### Report
127+
125128
The **Report** schema provides configuration of the Veeam VB365 report information.
126129

127130
| Sub-Schema | Setting | Default | Description |
@@ -138,25 +141,26 @@ The **Report** schema provides configuration of the Veeam VB365 report informati
138141

139142
The **Options** schema allows certain options within the report to be toggled on or off.
140143

141-
| Sub-Schema | Setting | Default | Description |
142-
| ---------------------- | ------------------- | ------- | ------------------------------------------------------------------------------ |
143-
| BackupServerPort | TCP Port | 9191 | Used to specify the backup service's custom port. |
144-
| ReportStyle | Veeam/AsBuiltReport | Veeam | Allow to set report style template. |
145-
| EnableDiagrams | true/false | true | Toggle to enable/disable the creation of infrastructure diagram. |
146-
| EnableDiagramsDebug | true/false | false | Toggle to enable/disable diagram debug option. |
147-
| DiagramWaterMark | string | empty | Used to set the diagram waterMark. |
148-
| DiagramTheme | string | White | Used to set the diagram theme. (Black/White/Neon) |
149-
| ExportDiagrams | true/false | false | Toggle to enable/disable diagram export option. |
150-
| ExportDiagramsFormat | string array | png | Set the format used to export the infrastructure diagram. (dot, png, pdf, svg) |
151-
| EnableDiagramSignature | true/false | false | Toggle to enable/disable diagram signature (button right corner) |
152-
| SignatureAuthorName | string | empty | Toggle to set signature author name. |
153-
| SignatureCompanyName | string | empty | Toggle to set signature company name. |
154-
155-
<!-- ********** Add/Remove the number of InfoLevels as required ********** -->
144+
| Sub-Schema | Setting | Default | Description |
145+
| ---------------------- | ------------------- | ------- | -------------------------------------------------------------------------------------------- |
146+
| BackupServerPort | TCP Port | 9191 | Specifies the custom port for the backup service. |
147+
| ReportStyle | Veeam/AsBuiltReport | Veeam | Sets the report style template. |
148+
| EnableDiagrams | true/false | true | Enables or disables the creation of infrastructure diagrams. |
149+
| EnableDiagramsDebug | true/false | false | Enables or disables the diagram debug option. |
150+
| DiagramWaterMark | string | empty | Sets the watermark for the diagram. |
151+
| DiagramTheme | string | White | Sets the diagram theme. Options are Black, White, or Neon. |
152+
| ExportDiagrams | true/false | false | Enables or disables the option to export diagrams. |
153+
| ExportDiagramsFormat | string array | png | Sets the format for exporting the infrastructure diagram. Options are dot, png, pdf, or svg. |
154+
| EnableDiagramSignature | true/false | false | Enables or disables the diagram signature in the bottom right corner. |
155+
| SignatureAuthorName | string | empty | Sets the author name for the diagram signature. |
156+
| SignatureCompanyName | string | empty | Sets the company name for the diagram signature. |
157+
| RoundUnits | int | 1 | Sets the rounding units for data values. |
158+
156159
### InfoLevel
160+
157161
The **InfoLevel** schema allows configuration of each section of the report at a granular level. The following sections can be set.
158162

159-
There are 3 levels (0-2) of detail granularity for each section as follows;
163+
There are 3 levels (0-2) of detail granularity for each section as follows:
160164

161165
| Setting | InfoLevel | Description |
162166
| :-----: | ----------------- | -------------------------------------------------------------------- |
@@ -191,6 +195,7 @@ The table below outlines the default and maximum **InfoLevel** settings for each
191195
| RestorePoint | 1 | 1 |
192196

193197
### Healthcheck
198+
194199
The **Healthcheck** schema is used to toggle health checks on or off.
195200

196201
## :computer: Examples
@@ -210,11 +215,10 @@ PS C:\> New-AsBuiltReport -Report Veeam.VB365 -Target veeam-vbr365.pharmax.local
210215
211216
# Generate a Veeam VB365 As Built Report for Backup Server veeam-vbr365.pharmax.local using stored credentials. Export report to HTML & DOCX formats. Use default report style. Reports are saved to the user profile folder by default. Attach and send reports via e-mail.
212217
PS C:\> New-AsBuiltReport -Report Veeam.VB365 -Target veeam-vbr365.pharmax.local -Username 'Domain\veeam_admin' -Password 'P@ssw0rd' -Format Html,Word -OutputFolderPath 'C:\Users\Jon\Documents' -SendEmail
213-
214218
```
215219

216220
## :x: Known Issues
217221

218222
- Error when generating a report in Word format.
219223
- Error Message: New-AsBuiltReport : The variable '$Images' cannot be retrieved because it has not been set
220-
- Fix: Disable the generation of the cover page image. Set ShowCoverPageImage to false
224+
- Fix: Disable the generation of the cover page image. Set ShowCoverPageImage to false

0 commit comments

Comments
 (0)