Add functions to manage URL reservations for Reporting Services (#2388)

Author: johlju

CHANGELOG.md

@@ -7,12 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Added public command `Set-SqlDscRSVirtualDirectory` to set the virtual directory
+  for Reporting Services applications. Wraps the `SetVirtualDirectory` CIM method
+  and supports ReportServerWebService, ReportServerWebApp, and ReportManager
+  applications ([issue #2015](https://github.com/dsccommunity/SqlServerDsc/issues/2015)).
+- Added public commands `Get-SqlDscRSUrlReservation`, `Add-SqlDscRSUrlReservation`,
+  `Remove-SqlDscRSUrlReservation`, and `Set-SqlDscRSUrlReservation` to manage
+  URL reservations for SQL Server Reporting Services or Power BI Report Server.
+  These commands wrap the `ListReservedUrls`, `ReserveUrl`, and `RemoveURL` CIM
+  methods respectively. The `Set-SqlDscRSUrlReservation` command provides a
+  declarative approach to set URL reservations to an exact list, removing any
+  existing reservations not in the specified list
+  ([issue #2016](https://github.com/dsccommunity/SqlServerDsc/issues/2016))
+  ([issue #2024](https://github.com/dsccommunity/SqlServerDsc/issues/2024)).
 - Added public command `Get-SqlDscRSConfiguration` to retrieve the
   `MSReportServer_ConfigurationSetting` CIM instance for SQL Server Reporting
   Services or Power BI Report Server. Supports auto-detection of the Reporting
   Services version or explicit version specification. The returned CIM instance
   can be piped to `Enable-SqlDscRsSecureConnection` or `Disable-SqlDscRsSecureConnection`
   ([issue #2022](https://github.com/dsccommunity/SqlServerDsc/issues/2022)).
+- Added public command `Get-SqlDscRSWebPortalApplicationName` to get the
+  Reporting Services web portal application name based on the SQL Server
+  version. Returns 'ReportServerWebApp' for SQL Server 2016 (version 13) and
+  later, or 'ReportManager' for earlier versions. Accepts the setup configuration
+  object from `Get-SqlDscRSSetupConfiguration` via pipeline.
 - Added public command `Enable-SqlDscRsSecureConnection` to enable secure
   connection for SQL Server Reporting Services or Power BI Report Server by
   setting the secure connection level to 1. Accepts the configuration CIM
@@ -131,6 +149,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Refactored to use the public commands `Enable-SqlDscRsSecureConnection` and
     `Disable-SqlDscRsSecureConnection` for setting the secure connection level
     instead of calling the CIM method directly.
+  - Refactored to use the public commands `Get-SqlDscRSUrlReservation`,
+    `Add-SqlDscRSUrlReservation`, `Remove-SqlDscRSUrlReservation`, and
+    `Set-SqlDscRSUrlReservation` for managing URL reservations instead of calling
+    the CIM methods directly.
+  - Refactored to use the public command `Set-SqlDscRSVirtualDirectory` for
+    setting virtual directories instead of calling the CIM method directly
+    ([issue #2015](https://github.com/dsccommunity/SqlServerDsc/issues/2015)).
 - `Assert-SetupActionProperties`
   - Refactored to use the command `Get-FileVersion` from the DscResource.Common
     module instead of the private function `Get-FileVersionInformation`

azure-pipelines.yml

@@ -539,6 +539,11 @@ stages:
                   'tests/Integration/Commands/Get-SqlDscRSConfiguration.Integration.Tests.ps1'
                   'tests/Integration/Commands/Enable-SqlDscRsSecureConnection.Integration.Tests.ps1'
                   'tests/Integration/Commands/Disable-SqlDscRsSecureConnection.Integration.Tests.ps1'
+                  'tests/Integration/Commands/Set-SqlDscRSVirtualDirectory.Integration.Tests.ps1'
+                  'tests/Integration/Commands/Get-SqlDscRSUrlReservation.Integration.Tests.ps1'
+                  'tests/Integration/Commands/Add-SqlDscRSUrlReservation.Integration.Tests.ps1'
+                  'tests/Integration/Commands/Remove-SqlDscRSUrlReservation.Integration.Tests.ps1'
+                  'tests/Integration/Commands/Set-SqlDscRSUrlReservation.Integration.Tests.ps1'
                   # Group 8
                   'tests/Integration/Commands/Repair-SqlDscReportingService.Integration.Tests.ps1'
                   # Group 9
@@ -609,6 +614,11 @@ stages:
                   'tests/Integration/Commands/Get-SqlDscRSConfiguration.Integration.Tests.ps1'
                   'tests/Integration/Commands/Enable-SqlDscRsSecureConnection.Integration.Tests.ps1'
                   'tests/Integration/Commands/Disable-SqlDscRsSecureConnection.Integration.Tests.ps1'
+                  'tests/Integration/Commands/Set-SqlDscRSVirtualDirectory.Integration.Tests.ps1'
+                  'tests/Integration/Commands/Get-SqlDscRSUrlReservation.Integration.Tests.ps1'
+                  'tests/Integration/Commands/Add-SqlDscRSUrlReservation.Integration.Tests.ps1'
+                  'tests/Integration/Commands/Remove-SqlDscRSUrlReservation.Integration.Tests.ps1'
+                  'tests/Integration/Commands/Set-SqlDscRSUrlReservation.Integration.Tests.ps1'
                   # Group 8
                   'tests/Integration/Commands/Repair-SqlDscPowerBIReportServer.Integration.Tests.ps1'
                   # Group 9