xSQLServerRSConfig: Adding examples

CHANGELOG.md

@@ -30,6 +30,8 @@
   - Added localization (en-US) for all strings in resource and unit tests
     ([issue #618](https://github.com/PowerShell/xSQLServer/issues/618)).
   - Updated examples to reflect new parameters.
+- Changes to xSQLServerRSConfig
+  - Added examples
 
 ## 8.2.0.0
 

Examples/Resources/xSQLServerRSConfig/1-DefaultConfiguration.ps1

@@ -0,0 +1,22 @@
+<#
+.EXAMPLE
+    This example performs a default SSRS configuration. It will initialize SSRS
+    and register default Report Server Web Service and Report Manager URLs:
+
+    http://localhost:80/ReportServer (Report Server Web Service)
+
+    http://localhost:80/Reports (Report Manager)
+#>
+Configuration Example
+{
+    Import-DscResource -ModuleName xSqlServer
+
+    node localhost {
+        xSQLServerRSConfig DefaultConfiguration
+        {
+            InstanceName = 'MSSQLSERVER'
+            RSSQLServer = 'localhost'
+            RSSQLInstanceName = 'MSSQLSERVER'
+        }
+    }
+}

Examples/Resources/xSQLServerRSConfig/2-CustomConfiguration.ps1

@@ -0,0 +1,31 @@
+<#
+.EXAMPLE
+    This example performs a custom SSRS configuration. It will initialize SSRS
+    and register custom Report Server Web Service and Report Manager URLs:
+
+    http://localhost:80/MyReportServer
+    https://localhost:443/MyReportServer (Report Server Web Service)
+
+    http://localhost:80/MyReports
+    https://localhost:443/MyReports (Report Manager)
+
+    Please note: this resource does not currently handle SSL bindings for HTTPS
+    endpoints.
+#>
+Configuration Example
+{
+    Import-DscResource -ModuleName xSqlServer
+
+    node localhost {
+        xSQLServerRSConfig DefaultConfiguration
+        {
+            InstanceName = 'MSSQLSERVER'
+            RSSQLServer = 'localhost'
+            RSSQLInstanceName = 'MSSQLSERVER'
+            ReportServerVirtualDirectory = 'MyReportServer'
+            ReportsVirtualDirectory = 'MyReports'
+            ReportServerReservedUrl = @('http://+:80', 'https://+:443')
+            ReportsReservedUrl = @('http://+:80', 'https://+:443')
+        }
+    }
+}

README.md

@@ -1140,7 +1140,8 @@ Initializes and configures SQL Reporting Services server.
 
 #### Examples
 
-None.
+* [Default configuration](Examples/Resources/xSQLServerRSConfig/1-DefaultConfiguration.ps1)
+* [Custom virtual directories and reserved URLs](Examples/Resources/xSQLServerRSConfig/2-CustomConfiguration.ps1)
 
 ### xSQLServerRSSecureConnectionLevel