docs: sanitize examples (#259)

- Updated Request-ValidatedSolutionOverview.md doc to sanitize all the example variables, add brackets and punctuation.
- Updated Request-VcenterAlert.md doc to sanitize all the example variables, add brackets and punctuation.
- Updated Request-VcenterAuthentication.md doc to sanitize all the example variables, add brackets and punctuation.
- Updated Request-VcenterBackupStatus.md doc to sanitize all the example variables, add brackets and punctuation.
- Updated Request-VcenterOverview.md doc to sanitize all the example variables, add brackets and punctuation.

Signed-off-by: Andy Beltz <andy.beltz@broadcom.com>

Author: andybeltz

docs/documentation/functions/Request-ValidatedSolutionOverview.md

@@ -2,7 +2,7 @@
 
 ## Synopsis
 
-Returns VMware Validated Solution Overview.
+Returns VMware Validated Solution overview.
 
 ## Syntax
 
@@ -12,21 +12,21 @@ Request-ValidatedSolutionOverview [-server] <String> [-user] <String> [-pass] <S
 
 ## Description
 
-The `Request-ValidatedSolutionOverview` cmdlet returns an overview of VMware Validated Solutions deployed.
+The `Request-ValidatedSolutionOverview` cmdlet returns an overview of VMware Validated Solutions that are deployed.
 The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
 
-- Validates that network connectivity is available to the SDDC Manager instance
-- Collects the VMware Validated Solution details
+- Validates that network connectivity is available to the SDDC Manager instance.
+- Collects the VMware Validated Solution details.
 
 ## Examples
 
 ### Example 1
 
 ```powershell
-Request-ValidatedSolutionOverview -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1!
+Request-ValidatedSolutionOverview -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password]
 ```
 
-This example will return an overview of VMware Validated Solutions.
+This example will return an overview of VMware Validated Solutions that are deployed.
 
 ## Parameters
 

docs/documentation/functions/Request-VcenterAlert.md

@@ -2,7 +2,7 @@
 
 ## Synopsis
 
-Returns alarms from vCenter Server managed by SDDC Manager.
+Returns alarms from a vCenter instance managed by SDDC Manager.
 
 ## Syntax
 
@@ -12,38 +12,38 @@ Request-VcenterAlert [-server] <String> [-user] <String> [-pass] <String> [-doma
 
 ## Description
 
-The `Request-VcenterAlert` cmdlet returns all alarms from vCenter Server managed by SDDC Manager.
+The `Request-VcenterAlert` cmdlet returns all alarms from a vCenter instance managed by SDDC Manager.
 The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
 
-- Validates that network connectivity is available to the vCenter Server instance
-- Validates the authentication to vCenter Server with credentials from SDDC Manager
-- Collects the alerts from vCenter Server
+- Validates that network connectivity is available to the vCenter instance.
+- Validates the authentication to vCenter with credentials from SDDC Manager.
+- Collects the alerts from vCenter.
 
 ## Examples
 
 ### Example 1
 
 ```powershell
-Request-VcenterAlert -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01
+Request-VcenterAlert -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name]
 ```
 
-This example will return alarms of a vCenter Server managed by SDDC Manager for a workload domain named sfo-w01.
+This example will return alarms of a vCenter managed by SDDC Manager for a specified workload domain.
 
 ### Example 2
 
 ```powershell
-Request-VcenterAlert -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01 -filterOut hostOnly
+Request-VcenterAlert -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name] -filterOut hostOnly
 ```
 
-This example will return alarms from ESXi hosts of a vCenter Server managed by SDDC Manager for a workload domain named sfo-w01.
+This example will return alarms from ESX hosts of a vCenter managed by SDDC Manager for a specified workload domain.
 
 ### Example 3
 
 ```powershell
-Request-VcenterAlert -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01 -failureOnly
+Request-VcenterAlert -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name] -failureOnly
 ```
 
-This example will return alarms from vSAN clusters of a vCenter Server managed by SDDC Manager for a workload domain but only for the failed items.
+This example will return alarms from vSAN clusters of a vCenter managed by SDDC Manager for a specified workload domain but only reports issues.
 
 ## Parameters
 

docs/documentation/functions/Request-VcenterAuthentication.md

@@ -2,55 +2,56 @@
 
 ## Synopsis
 
-Checks API authentication to vCenter Server instance.
+Checks API authentication to a vCenter instance.
 
 ## Syntax
 
 ### All-WorkloadDomains
 
 ```powershell
-Request-VcenterAuthentication -server <String> -user <String> -pass <String> [-allDomains] [-failureOnly] [<CommonParameters>]
+Request-VcenterAuthentication [-server] <String> [-user] <String> [-pass] <String> [-allDomains] [-failureOnly] [<CommonParameters>]
 ```
 
 ### Specific-WorkloadDomains
 
 ```powershell
-Request-VcenterAuthentication -server <String> -user <String> -pass <String> -workloadDomain <String> [-failureOnly] [<CommonParameters>]
+Request-VcenterAuthentication [-server] <String> [-user] <String> [-pass] <String> [-workloadDomain] <String> [-failureOnly] [<CommonParameters>]
 ```
 
 ## Description
 
-The `Request-VcenterAuthentication` cmdlets checks the authentication to vCenter Server instance.
+The `Request-VcenterAuthentication` cmdlets checks the authentication to a vCenter instance.
 The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
 
-- Validates that network connectivity is available to the SDDC Manager instance
-- Validates that network connectivity is available to the vCenter Server instance
+- Validates that network connectivity is available to the SDDC Manager instance.
+- Validates the authentication to vCenter with credentials from SDDC Manager.
+- Validates that network connectivity is available to the vCenter instance.
 
 ## Examples
 
 ### Example 1
 
 ```powershell
-Request-VcenterAuthentication -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -allDomains
+Request-VcenterAuthentication -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -allDomains
 ```
 
-This example will check authentication to vCenter Server API for all vCenter Server instances managed by SDDC Manager.
+This example will check authentication to vCenter API for all vCenter instances managed by SDDC Manager.
 
 ### Example 2
 
 ```powershell
-Request-VcenterAuthentication -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -workloadDomain sfo-w01
+Request-VcenterAuthentication -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -workloadDomain [workload_domain_name]
 ```
 
-This example will check authentication to vCenter Server API for a single workload domain
+This example will check authentication to vCenter API for a specified workload domain.
 
 ### Example 3
 
 ```powershell
-Request-VcenterAuthentication -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -allDomains -failureOnly
+Request-VcenterAuthentication -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -allDomains -failureOnly
 ```
 
-This example will check authentication to vCenter Server API for all vCenter Server instances but only reports issues.
+This example will check authentication to vCenter API for all vCenter instances managed by SDDC Manager but only reports issues.
 
 ## Parameters
 

docs/documentation/functions/Request-VcenterBackupStatus.md

@@ -2,7 +2,7 @@
 
 ## Synopsis
 
-Returns the status of the file-level latest backup of a vCenter Server instance.
+Returns the status of the latest file-level backup of a vCenter instance.
 
 ## Syntax
 
@@ -12,31 +12,31 @@ Request-VcenterBackupStatus [-server] <String> [-user] <String> [-pass] <String>
 
 ## Description
 
-The `Request-VcenterBackupStatus` cmdlet returns the status of the latest backup of a vCenter Server instance.
+The `Request-VcenterBackupStatus` cmdlet returns the status of the latest file-level backup of a vCenter instance.
 The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
 
-- Validates network connectivity and authentication to the SDDC Manager instance
-- Gathers the details for the NvCenter Server instance from the SDDC Manager
-- Validates network connectivity and authentication to the vCenter Server instance
-- Collects the file-level backup status details
+- Validates network connectivity and authentication to the SDDC Manager instance.
+- Gathers the details for the vCenter instance from the SDDC Manager.
+- Validates network connectivity and authentication to the vCenter instance.
+- Collects the file-level backup status details.
 
 ## Examples
 
 ### Example 1
 
 ```powershell
-Request-VcenterBackupStatus -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01
+Request-VcenterBackupStatus -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name]
 ```
 
-This example will return the status of the latest file-level backup of a vCenter Server instance managed by SDDC Manager for a workload domain.
+This example will return the status of the latest file-level backup of a vCenter instance managed by SDDC Manager for a specified workload domain.
 
 ### Example 2
 
 ```powershell
-Request-VcenterBackupStatus -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01 -failureOnly
+Request-VcenterBackupStatus -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name] -failureOnly
 ```
 
-This example will return the status of the latest file-level backup of a vCenter Server instance managed by SDDC Manager for a workload domain but only reports issues.
+This example will return the status of the latest file-level backup of a vCenter instance managed by SDDC Manager for a specified workload domain but only reports issues.
 
 ## Parameters
 

docs/documentation/functions/Request-VcenterOverview.md

@@ -2,7 +2,7 @@
 
 ## Synopsis
 
-Returns overview of vSphere.
+Returns an overview of vSphere.
 
 ## Syntax
 
@@ -15,27 +15,27 @@ Request-VcenterOverview [-server] <String> [-user] <String> [-pass] <String> [-a
 The `Request-VcenterOverview` cmdlet returns an overview of the vSphere environment managed by SDDC Manager.
 The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
 
-- Validates that network connectivity and authentication to the SDDC Manager instance
-- Validates that network connectivity and authentication to the vCenter Server instances
-- Collects the vSphere overview detail
+- Validates that network connectivity and authentication is available to the SDDC Manager instance.
+- Validates that network connectivity and authentication is available to the vCenter instances.
+- Collects the vSphere overview detail.
 
 ## Examples
 
 ### Example 1
 
 ```powershell
-Request-VcenterOverview -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1!
+Request-VcenterOverview -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password]
 ```
 
-This example will return an overview of the vSphere environment managed by the SDDC Manager instance.
+This example will return an overview of the vSphere environment managed by SDDC Manager.
 
 ### Example 2
 
 ```powershell
-Request-VcenterOverview -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -aanonymized
+Request-VcenterOverview -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -anonymized
 ```
 
-This example will return an overview of the vSphere environment managed by the SDDC Manager instance, but will anonymize the output.
+This example will return an overview of the vSphere environment managed by SDDC Manager, but will anonymize the output.
 
 ## Parameters