Skip to content

Commit ed364e2

Browse files
authored
docs: sanitize examples (#256)
- Updated `Request-HardwareOverview.md` doc to sanitize all the example variables, add brackets and punctuation. - Updated `Request-NetworkOverview.md` doc to sanitize all the example variables, add brackets and punctuation. - Updated `Request-NsxtAlert.md` doc to sanitize all the example variables, add brackets and punctuation. - Updated `Request-NsxtAuthentication.md` doc to sanitize all the example variables, add brackets and punctuation. - Updated `Request-NsxtComputeManagerStatus.md` doc to sanitize all the example variables, add brackets and punctuation. - Updated `Request-NsxtEdgeSnapshotStatus.md` doc to sanitize all the example variables, add brackets and punctuation. - Updated `Request-NsxtManagerBackupStatus.md` doc to sanitize all the example variables, add brackets and punctuation. Signed-off-by: Andy Beltz <andy.beltz@broadcom.com>
1 parent 01103ca commit ed364e2

7 files changed

Lines changed: 61 additions & 61 deletions

docs/documentation/functions/Request-HardwareOverview.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Synopsis
44

5-
Returns Hardware Overview.
5+
Returns hardware overview.
66

77
## Syntax
88

@@ -15,18 +15,18 @@ Request-HardwareOverview [-server] <String> [-user] <String> [-pass] <String> [<
1515
The `Request-VcfOverview` cmdlet returns an overview of the hardware in an SDDC Manager instance.
1616
The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
1717

18-
- Validates that network connectivity is available to the SDDC Manager instance
19-
- Collects the hardware details
18+
- Validates that network connectivity is available to the SDDC Manager instance.
19+
- Collects the hardware details.
2020

2121
## Examples
2222

2323
### Example 1
2424

2525
```powershell
26-
Request-HardwareOverview -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1!
26+
Request-HardwareOverview -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password]
2727
```
2828

29-
This example will return an overview of the SDDC Manager instance.
29+
This example will return a hardware overview of the SDDC Manager instance.
3030

3131
## Parameters
3232

docs/documentation/functions/Request-NetworkOverview.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,23 +15,23 @@ Request-NetworkOverview [-server] <String> [-user] <String> [-pass] <String> [-a
1515
The `Request-NetworkOverview` cmdlet returns an overview of the networking managed by SDDC Manager.
1616
The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
1717

18-
- Validates that network connectivity and authentication to the SDDC Manager instance
19-
- Collects the networking overview detail
18+
- Validates that network connectivity and authentication to the SDDC Manager instance.
19+
- Collects the networking overview detail.
2020

2121
## Examples
2222

2323
### Example 1
2424

2525
```powershell
26-
Request-NetworkOverview -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1!
26+
Request-NetworkOverview -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password]
2727
```
2828

2929
This example will return an overview of the networking managed by the SDDC Manager instance.
3030

3131
### Example 2
3232

3333
```powershell
34-
Request-NetworkOverview -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -anonymized
34+
Request-NetworkOverview -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -anonymized
3535
```
3636

3737
This example will return an overview of the networking managed by the SDDC Manager instance, but will anonymize the output.

docs/documentation/functions/Request-NsxtAlert.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Synopsis
44

5-
Returns alarms from an NSX Manager cluster.
5+
Returns alarms from NSX.
66

77
## Syntax
88

@@ -12,31 +12,31 @@ Request-NsxtAlert [-server] <String> [-user] <String> [-pass] <String> [-domain]
1212

1313
## Description
1414

15-
The `Request-NsxtAlert` cmdlet returns all alarms from an NSX Manager cluster.
15+
The `Request-NsxtAlert` cmdlet returns all alarms from NSX.
1616
The cmdlet connects to the NSX Manager using the `-server`, `-user`, and `-pass` values:
1717

18-
- Validates that network connectivity is available to the NSX Manager cluster
19-
- Validates that network connectivity is available to the vCenter Server instance
20-
- Gathers the details for the NSX Manager cluster
21-
- Collects the alerts
18+
- Validates that network connectivity is available to NSX.
19+
- Validates that network connectivity is available to the vCenter instance.
20+
- Gathers the details for NSX.
21+
- Collects the alerts.
2222

2323
## Examples
2424

2525
### Example 1
2626

2727
```powershell
28-
Request-NsxtAlert -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01
28+
Request-NsxtAlert -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name]
2929
```
3030

31-
This example will return alarms of an NSX Manager cluster managed by SDDC Manager for a workload domain.
31+
This example will return alarms of NSX managed by SDDC Manager for a specified workload domain.
3232

3333
### Example 2
3434

3535
```powershell
36-
Request-NsxtAlert -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01 -failureOnly
36+
Request-NsxtAlert -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name] -failureOnly
3737
```
3838

39-
This example will return alarms of an NSX Manager cluster managed by SDDC Manager for a workload domain but only for the failed items.
39+
This example will return alarms of NSX managed by SDDC Manager for a specified workload domain but only reports issues.
4040

4141
## Parameters
4242

docs/documentation/functions/Request-NsxtAuthentication.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,55 +2,55 @@
22

33
## Synopsis
44

5-
Checks API authentication to NSX Manager cluster.
5+
Checks API authentication to NSX.
66

77
## Syntax
88

99
### All-WorkloadDomains
1010

1111
```powershell
12-
Request-NsxtAuthentication -server <String> -user <String> -pass <String> [-allDomains] [-failureOnly] [<CommonParameters>]
12+
Request-NsxtAuthentication [-server] <String> [-user] <String> [-pass] <String> [-allDomains] [-failureOnly] [<CommonParameters>]
1313
```
1414

1515
### Specific-WorkloadDomains
1616

1717
```powershell
18-
Request-NsxtAuthentication -server <String> -user <String> -pass <String> -workloadDomain <String> [-failureOnly] [<CommonParameters>]
18+
Request-NsxtAuthentication [-server] <String> [-user] <String> [-pass] <String> [-workloadDomain] <String> [-failureOnly] [<CommonParameters>]
1919
```
2020

2121
## Description
2222

23-
The `Request-NsxtAuthentication` cmdlets checks the authentication to NSX Manager cluster.
23+
The `Request-NsxtAuthentication` cmdlets checks the authentication to NSX.
2424
The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
2525

26-
- Validates that network connectivity is available to the SDDC Manager instance
27-
- Validates that network connectivity is available to the NSX Manager cluster
26+
- Validates that network connectivity is available to the SDDC Manager instance.
27+
- Validates that network connectivity is available to NSX.
2828

2929
## Examples
3030

3131
### Example 1
3232

3333
```powershell
34-
Request-NsxtAuthentication -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -allDomains
34+
Request-NsxtAuthentication -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -allDomains
3535
```
3636

37-
This example will check authentication to NSX Manager API for all NSX Manager clusters managed by SDDC Manager.
37+
This example will check authentication to the NSX API for all instances of NSX managed by SDDC Manager.
3838

3939
### Example 2
4040

4141
```powershell
42-
Request-NsxtAuthentication -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -workloadDomain sfo-w01
42+
Request-NsxtAuthentication -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -workloadDomain [workload_domain_name]
4343
```
4444

45-
This example will check authentication to NSX Manager API for a single workload domain
45+
This example will check authentication to the NSX API for a specified workload domain.
4646

4747
### Example 3
4848

4949
```powershell
50-
Request-NsxtAuthentication -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -allDomains -failureOnly
50+
Request-NsxtAuthentication -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -allDomains -failureOnly
5151
```
5252

53-
This example will check authentication to NSX Manager API for all NSX Manager clusters but only reports issues.
53+
This example will check authentication to the NSX API for all instances of NSX managed by SDDC Manager but only reports issues.
5454

5555
## Parameters
5656

docs/documentation/functions/Request-NsxtComputeManagerStatus.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Synopsis
44

5-
Returns the status of the compute managers attached to an NSX Manager cluster.
5+
Returns the status of the compute managers attached to NSX.
66

77
## Syntax
88

@@ -12,31 +12,31 @@ Request-NsxtComputeManagerStatus [-server] <String> [-user] <String> [-pass] <St
1212

1313
## Description
1414

15-
The `Request-NsxtComputeManagerStatus` cmdlet returns the status of the compute managers attached to an NSX Manager cluster.
15+
The `Request-NsxtComputeManagerStatus` cmdlet returns the status of the compute managers attached to NSX.
1616
The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
1717

18-
- Validates network connectivity and authentication to the SDDC Manager instance
19-
- Gathers the details for the NSX Manager cluster from the SDDC Manager
20-
- Validates network connectivity and authentication to the NSX Local Manager cluster
21-
- Collects the status of the compute managers
18+
- Validates network connectivity and authentication to the SDDC Manager instance.
19+
- Gathers the details for NSX from the SDDC Manager.
20+
- Validates network connectivity and authentication to NSX.
21+
- Collects the status of the compute managers.
2222

2323
## Examples
2424

2525
### Example 1
2626

2727
```powershell
28-
Request-NsxtComputeManagerStatus -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01
28+
Request-NsxtComputeManagerStatus -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name]
2929
```
3030

31-
This example will return the status of the compute managers attached to an NSX Manager cluster managed by SDDC Manager for a workload domain.
31+
This example will return the status of the compute managers attached to NSX managed by SDDC Manager for a specified workload domain.
3232

3333
### Example 2
3434

3535
```powershell
36-
Request-NsxtComputeManagerStatus -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01 -failureOnly
36+
Request-NsxtComputeManagerStatus -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name] -failureOnly
3737
```
3838

39-
This example will return the status of the compute managers attached to an NSX Manager cluster managed by SDDC Manager for a workload domain but only reports issues.
39+
This example will return the status of the compute managers attached to NSX managed by SDDC Manager for a specified workload domain but only reports issues.
4040

4141
## Parameters
4242

docs/documentation/functions/Request-NsxtEdgeSnapshotStatus.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Synopsis
44

5-
Request the snapshot status for NSX Edge nodes.
5+
Request the snapshot status for NSX edge nodes.
66

77
## Syntax
88

@@ -12,31 +12,31 @@ Request-NsxtEdgeSnapshotStatus [-server] <String> [-user] <String> [-pass] <Stri
1212

1313
## Description
1414

15-
The `Request-NsxtEdgeSnapshotStatus` cmdlet checks the snapshot status for NSX Edge nodes.
15+
The `Request-NsxtEdgeSnapshotStatus` cmdlet checks the snapshot status for NSX edge nodes.
1616
The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
1717

18-
- Validates network connectivity and authentication to the SDDC Manager instance
19-
- Gathers the NSX Manager and NSX Edge node details from the SDDC Manager
20-
- Validates network connectivity and authentication to the vCenter Server instance
21-
- Performs checks on the snapshot status and outputs the results
18+
- Validates network connectivity and authentication to the SDDC Manager instance.
19+
- Gathers the NSX service and edge node details from the SDDC Manager.
20+
- Validates network connectivity and authentication to the vCenter instance.
21+
- Performs checks on the snapshot status and outputs the results.
2222

2323
## Examples
2424

2525
### Example 1
2626

2727
```powershell
28-
Request-NsxtEdgeSnapshotStatus -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01
28+
Request-NsxtEdgeSnapshotStatus -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name]
2929
```
3030

31-
This example will publish the snapshot status for all NSX Edge nodes managed by SDDC Manager for a specific workload domain.
31+
This example will publish the snapshot status for all NSX edge nodes managed by SDDC Manager for a specified workload domain.
3232

3333
### Example 2
3434

3535
```powershell
36-
Request-NsxtEdgeSnapshotStatus -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01 -failureOnly
36+
Request-NsxtEdgeSnapshotStatus -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name] -failureOnly
3737
```
3838

39-
This example will publish the snapshot status for all NSX Edge nodes managed by SDDC Manager for a specific workload domain. but only failed items.
39+
This example will publish the snapshot status for all NSX edge nodes managed by SDDC Manager for a specified workload domain but only reports issues.
4040

4141
## Parameters
4242

docs/documentation/functions/Request-NsxtManagerBackupStatus.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Synopsis
44

5-
Returns the status of the latest file-level backup of an NSX Manager cluster.
5+
Returns the status of the latest file-level backup of an NSX.
66

77
## Syntax
88

@@ -12,31 +12,31 @@ Request-NsxtManagerBackupStatus [-server] <String> [-user] <String> [-pass] <Str
1212

1313
## Description
1414

15-
The `Request-NsxtManagerBackupStatus` cmdlet returns the status of the latest backup of an NSX Manager cluster.
15+
The `Request-NsxtManagerBackupStatus` cmdlet returns the status of the latest backup of an NSX instance.
1616
The cmdlet connects to the SDDC Manager using the `-server`, `-user`, and `-pass` values:
1717

18-
- Validates network connectivity and authentication to the SDDC Manager instance
19-
- Gathers the details for the NSX Manager cluster from the SDDC Manager
20-
- Validates network connectivity and authentication to the NSX Manager cluster
21-
- Collects the file-level backup status details
18+
- Validates network connectivity and authentication to the SDDC Manager instance.
19+
- Gathers the details for NSX from the SDDC Manager.
20+
- Validates network connectivity and authentication to NSX.
21+
- Collects the file-level backup status details.
2222

2323
## Examples
2424

2525
### Example 1
2626

2727
```powershell
28-
Request-NsxtManagerBackupStatus -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01
28+
Request-NsxtManagerBackupStatus -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name]
2929
```
3030

31-
This example will return the status of the latest file-level backup of an NSX Manager cluster managed by SDDC Manager for a workload domain.
31+
This example will return the status of the latest file-level backup of NSX managed by SDDC Manager for a specified workload domain.
3232

3333
### Example 2
3434

3535
```powershell
36-
Request-NsxtManagerBackupStatus -server sfo-vcf01.sfo.rainpole.io -user admin@local -pass VMw@re1!VMw@re1! -domain sfo-w01 -failureOnly
36+
Request-NsxtManagerBackupStatus -server [sddc_manager_fqdn] -user [admin_username] -pass [admin_password] -domain [workload_domain_name] -failureOnly
3737
```
3838

39-
This example will return the status of the latest file-level backup of an NSX Manager cluster managed by SDDC Manager for a workload domain but only reports issues.
39+
This example will return the status of the latest file-level backup of NSX managed by SDDC Manager for a specified workload domain but only reports issues.
4040

4141
## Parameters
4242

0 commit comments

Comments
 (0)