Refactor parameter descriptions across multiple scripts for clarity and consistency

Author: johlju

source/Public/Install-SqlDscBIReportServer.ps1

@@ -6,7 +6,8 @@
         Installs SQL Server Power BI Report Server using the provided setup executable.
 
     .PARAMETER AcceptLicensingTerms
-        Required parameter to be able to run unattended install. By specifying this
+        Specifies that the acceptance of all license terms and notices for the
+        specified features is required to be able to run unattended install. By specifying this
         parameter you acknowledge the acceptance of all license terms and notices for
         the specified features, the terms and notices that the setup executable
         normally asks for.
@@ -20,7 +21,7 @@
         This parameter is mutually exclusive with the parameter Edition.
 
     .PARAMETER EditionUpgrade
-        Upgrades the edition of the installed product. Requires that either the
+        Specifies whether to upgrade the edition of the installed product. Requires that either the
         ProductKey or the Edition parameter is also assigned. By default no edition
         upgrade is performed.
 
@@ -40,7 +41,7 @@
         PI Report Server: %ProgramFiles%\Microsoft Power BI Report Server
 
     .PARAMETER SuppressRestart
-        Suppresses the restart of the computer after the installation is finished.
+        Specifies whether to suppress the restart of the computer after the installation is finished.
         By default the computer is restarted after the installation is finished.
 
     .PARAMETER Timeout
@@ -49,11 +50,11 @@
         this time, an exception will be thrown.
 
     .PARAMETER Force
-        If specified the command will not ask for confirmation. Same as if Confirm:$false
+        Specifies whether the command will not ask for confirmation. Same as if Confirm:$false
         is used.
 
     .PARAMETER PassThru
-        If specified the command will return the setup process exit code.
+        Specifies whether the command will return the setup process exit code.
 
     .OUTPUTS
         When PassThru is specified the function will return the setup process exit

source/Public/Invoke-SqlDscQuery.ps1

@@ -29,21 +29,21 @@
         Specifies the name of the database to execute the T-SQL query in.
 
     .PARAMETER Query
-        The query string to execute.
+        Specifies the query string to execute.
 
     .PARAMETER PassThru
-        Specifies if the command should return any result the query might return.
+        Specifies whether the command should return any result the query might return.
 
     .PARAMETER StatementTimeout
-        Set the query StatementTimeout in seconds. Default 600 seconds (10 minutes).
+        Specifies the query StatementTimeout in seconds. Default 600 seconds (10 minutes).
 
     .PARAMETER RedactText
-        One or more text strings to redact from the query when verbose messages
+        Specifies one or more text strings to redact from the query when verbose messages
         are written to the console. Strings will be escaped so they will not
         be interpreted as regular expressions (RegEx).
 
     .PARAMETER Encrypt
-        Specifies if encryption should be used.
+        Specifies whether encryption should be used.
 
     .PARAMETER Force
         Specifies that the query should be executed without any confirmation.

source/Public/New-SqlDscAgentOperator.ps1

@@ -45,7 +45,7 @@
         Specifies the weekday pager start time for the SQL Agent Operator.
 
     .PARAMETER PassThru
-        If specified, the created operator object will be returned.
+        Specifies whether the created operator object will be returned.
 
     .PARAMETER Force
         Specifies that the operator should be created without any confirmation.

source/Public/Set-SqlDscAgentAlert.ps1

@@ -24,7 +24,7 @@
         Cannot be used together with Severity.
 
     .PARAMETER PassThru
-        If specified, the updated alert object will be returned.
+        Specifies whether the updated alert object will be returned.
 
     .PARAMETER Refresh
         Specifies that the alert object should be refreshed before updating. This

source/Public/Uninstall-SqlDscReportingService.ps1

@@ -15,7 +15,7 @@
         By default log files are created under %TEMP%.
 
     .PARAMETER SuppressRestart
-        Suppresses the restart of the computer after the uninstallation is finished.
+        Specifies whether to suppress the restart of the computer after the uninstallation is finished.
         By default the computer is restarted after the uninstallation is finished.
 
     .PARAMETER Timeout
@@ -24,11 +24,11 @@
         this time, an exception will be thrown.
 
     .PARAMETER Force
-        If specified the command will not ask for confirmation. Same as if Confirm:$false
+        Specifies whether the command will not ask for confirmation. Same as if Confirm:$false
         is used.
 
     .PARAMETER PassThru
-        If specified the command will return the setup process exit code.
+        Specifies whether the command will return the setup process exit code.
 
     .OUTPUTS
         When PassThru is specified the function will return the setup process exit