Skip to content

Commit 69a6349

Browse files
authored
Merge pull request #50 from rebelinux/dev
v0.3.9
2 parents b188967 + 9537625 commit 69a6349

12 files changed

+291
-240
lines changed

.github/workflows/Release.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ jobs:
5353
needs: publish-to-gallery
5454
runs-on: ubuntu-latest
5555
steps:
56-
- uses: zentered/bluesky-post-action@v0.1.0
56+
- uses: zentered/bluesky-post-action@v0.2.0
5757
with:
5858
post: "[New Release] ${{ github.event.repository.name }} ${{ github.event.release.tag_name }}! Check out what's new! ${{ github.event.release.html_url }} #Veeam #AsBuiltReport #PowerShell #VeeamVanguard #VeeamLegend"
5959
env:

AsBuiltReport.Veeam.VB365.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,8 @@
1919
"ExportDiagramsFormat": ["png"],
2020
"EnableDiagramSignature": false,
2121
"SignatureAuthorName": "",
22-
"SignatureCompanyName": ""
22+
"SignatureCompanyName": "",
23+
"RoundUnits": 1
2324
},
2425
"InfoLevel": {
2526
"_comment_": "Please refer to the AsBuiltReport project contributing guide for information about how to define InfoLevels.",

AsBuiltReport.Veeam.VB365.psd1

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727
# CompanyName = 'Unknown'
2828

2929
# Copyright statement for this module
30-
Copyright = '(c) 2024 Jonathan Colon. All rights reserved.'
30+
Copyright = '(c) 2025 Jonathan Colon. All rights reserved.'
3131

3232
# Description of the functionality provided by this module
3333
Description = 'A PowerShell module to generate an as built report on the configuration of Veeam Backup for Microsoft 365.'
@@ -55,15 +55,15 @@
5555
RequiredModules = @(
5656
@{
5757
ModuleName = 'AsBuiltReport.Core';
58-
ModuleVersion = '1.4.1'
58+
ModuleVersion = '1.4.2.1'
5959
},
6060
@{
6161
ModuleName = 'PScriboCharts';
6262
ModuleVersion = '0.9.0'
6363
},
6464
@{
6565
ModuleName = 'Diagrammer.Core';
66-
ModuleVersion = '0.2.13'
66+
ModuleVersion = '0.2.19'
6767
}
6868
)
6969

CHANGELOG.md

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
##### This project is community maintained and has no sponsorship from Veeam, its employees or any of its affiliates.
99

10-
## [0.3.9] - Unreleased
10+
## [0.3.9] - 2025-03-04
11+
12+
### Added
13+
14+
- Improve disk space information
15+
- Improve RESTful API section details
1116

1217
### Changed
1318

14-
- Change the infrastructure diagram default save location to $OutputFolderPath
15-
- Increase Diagrammer.Core to v0.2.13
16-
- Increase AsBuiltReport.Core to v1.4.1
19+
- Update GitHub release workflow for Bluesky integration
20+
- Update sample report and diagram files
21+
- Increase dependencies to latest versions
22+
23+
### Fixed
24+
25+
- Resolve issue with diagram watermark text generation
1726

1827
## [0.3.8] - 2024-11-12
1928

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
72.6 KB
Loading

0 commit comments

Comments
 (0)