Skip to content

Commit 2faa9b0

Browse files
committed
Bulk text formatting updates to the clusterawareupdating module
1 parent 6f930d2 commit 2faa9b0

17 files changed

+166
-168
lines changed

docset/winserver2022-ps/clusterawareupdating/Add-CauClusterRole.md

Lines changed: 31 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
description: Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
33
external help file: ClusterAwareUpdating.dll-Help.xml
44
Module Name: ClusterAwareUpdating
5-
ms.date: 12/20/2016
5+
ms.date: 09/27/2022
66
online version: https://learn.microsoft.com/powershell/module/clusterawareupdating/add-cauclusterrole?view=windowsserver2022-ps&wt.mc_id=ps-gethelp
77
schema: 2.0.0
88
title: Add-CauClusterRole
@@ -42,13 +42,13 @@ Add-CauClusterRole [-VirtualComputerObjectName <String>] [-GroupName <String>]
4242
```
4343

4444
## DESCRIPTION
45-
The **Add-CauClusterRole** cmdlet adds the Cluster-Aware Updating (CAU) clustered role that provides
45+
The `Add-CauClusterRole` cmdlet adds the Cluster-Aware Updating (CAU) clustered role that provides
4646
the self-updating functionality to the specified cluster. When the CAU clustered role has been added
4747
to a cluster, the failover cluster can update itself on the schedule that is specified by the user,
4848
without requiring an external computer to coordinate the cluster updating process.
4949

5050
To run this cmdlet, Windows PowerShell® remoting must be enabled on each node. To do this, run the
51-
**Enable-PSRemoting** cmdlet. In addition, ensure that the Windows Remote Management - Compatibility
51+
`Enable-PSRemoting` cmdlet. In addition, ensure that the Windows Remote Management - Compatibility
5252
Mode (HTTP-In) firewall exception is enabled on each node.
5353

5454
## EXAMPLES
@@ -63,8 +63,8 @@ The CAU clustered role is configured to perform Updating Runs on Tuesdays and Sa
6363
second and fourth weeks of each month. In an Updating Run, the maximum number of failed nodes is two
6464
and the maximum number of retries per node is two. A script called verifyupdatesinstalled.ps1 runs
6565
on each node after it has been fully updated. Before an Updating Run can begin, all the nodes of
66-
that cluster must be running. If it is not already enabled, the Remote Shutdown Windows Firewall
67-
rule group will be enabled on each cluster node. Because the command uses the *Force* parameter, the
66+
that cluster must be running. If it isn't already enabled, the Remote Shutdown Windows Firewall
67+
rule group will be enabled on each cluster node. Because the command uses the **Force** parameter, the
6868
cmdlet runs without displaying confirmation prompts.
6969

7070
### Example 2: Add a CAU clustered role on the specified cluster at a specific interval
@@ -76,9 +76,9 @@ This command adds the CAU clustered role, using a default name, on the cluster c
7676
The CAU clustered role is configured to perform Updating Runs on Tuesdays and Saturdays at an
7777
interval of every three weeks. In an Updating Run, the maximum number of failed nodes is two and the
7878
maximum number of retries per node is two. Updating Runs can begin even when the nodes of the
79-
cluster are not all running (if the cluster itself has quorum and is running). If it is not already
79+
cluster aren't all running (if the cluster itself has quorum and is running). If it isn't already
8080
enabled, the Remote Shutdown Windows Firewall rule group will be enabled on each cluster node.
81-
Because the command uses the *Force* parameter, the cmdlet runs without displaying confirmation
81+
Because the command uses the **Force** parameter, the cmdlet runs without displaying confirmation
8282
prompts.
8383

8484
### Example 3: Add a CAU clustered role on the specified cluster using plug-ins
@@ -88,12 +88,12 @@ PS C:\> Add-CauClusterRole -ClusterName "CONTOSO-FC1" -CauPluginName Microsoft.W
8888

8989
This command adds the CAU clustered role, using a default name, on the cluster called CONTOSO-FC1.
9090
The CAU clustered role is configured to perform updates using the **Microsoft.WindowsUpdatePlugin**
91-
plug-in with the optional *IncludeRecommendedUpdates* parameter set to True, and using the
91+
plug-in with the optional **IncludeRecommendedUpdates** parameter set to True, and using the
9292
**Microsoft.HotfixPlugin plug-in** using the hotfix root folder \\\\CauHotfixSrv\shareName and the
9393
default hotfix configuration file. If a failure occurs during the installation of updates on a node
9494
by **Microsoft.WindowsUpdatePlugin**, updates are applied by **Microsoft.HotfixPlugin plug-in**. If
95-
it is not already enabled, the Remote Shutdown Windows Firewall rule group is enabled on each
96-
cluster node. Because the command uses the *Force* parameter, the cmdlet runs without displaying
95+
it isn't already enabled, the Remote Shutdown Windows Firewall rule group is enabled on each
96+
cluster node. Because the command uses the **Force** parameter, the cmdlet runs without displaying
9797
confirmation prompts.
9898

9999
## PARAMETERS
@@ -105,7 +105,7 @@ For instance, to specify a Domain argument for one plug-in:
105105
You can specify multiple pairs in a set separated with semicolons.
106106
For instance:
107107
- `@{name1=value1;name2=value2;name3=value3}` These name=value pairs must be meaningful to the
108-
*CauPluginName* parameter that you specify. If you specify arguments for more than one plug-in,
108+
**CauPluginName** parameter that you specify. If you specify arguments for more than one plug-in,
109109
provide the sets of name=value pairs in the order that you pass values in **CauPluginName**,
110110
separated by commas. For instance:
111111
- `@{name1=value1;name2=value2;name3=value3},@{name4=value4;name5=value5}`
@@ -178,7 +178,7 @@ Accept wildcard characters: False
178178
179179
### -ClusterName
180180
Specifies the name of the cluster on which to create the CAU clustered role. This parameter is only
181-
required when this cmdlet is not run on a failover cluster node, or this cmdlet is used to reference
181+
required when this cmdlet isn't run on a failover cluster node, or this cmdlet is used to reference
182182
a failover cluster different from where the cmdlet is run.
183183
184184
```yaml
@@ -195,9 +195,9 @@ Accept wildcard characters: False
195195
196196
### -ConfigurationName
197197
Specifies the Windows PowerShell session configuration that defines the session in which scripts,
198-
specified by the *PreUpdateScript* and *PostUpdateScript* parameters, and cmdlets are run, and can
198+
specified by the **PreUpdateScript** and **PostUpdateScript** parameters, and cmdlets are run, and can
199199
limit the cmdlets that are available to be run. If either a pre-update or post-update script is
200-
specified but a configuration name is not specified, then the default session configuration that is
200+
specified but a configuration name isn't specified, then the default session configuration that is
201201
built into Windows PowerShell® is used.
202202
203203
```yaml
@@ -271,13 +271,13 @@ Accept wildcard characters: False
271271
272272
### -EnableFirewallRules
273273
Indicates that the cmdlet enables the Remote Shutdown Windows Firewall rule group on each cluster
274-
node, if it is not already enabled. If the *EnableFirewallRules* parameter is specified, CAU will
274+
node, if it isn't already enabled. If the **EnableFirewallRules** parameter is specified, CAU will
275275
also automatically re-enable the Remote Shutdown rule group each time the CAU clustered role
276276
performs an Updating Run, in case the rules are disabled manually in the intervening time. Enabling
277277
this rule group permits inbound communication to each cluster node during each Updating Run that
278278
allows CAU to shut down and restart the node remotely (if the installation of an update requires a
279-
restart). If Windows Firewall is in use on the cluster nodes and the rule group is not enabled, the
280-
Updating Run will fail. The Remote Shutdown Windows Firewall rule group is not enabled when it will
279+
restart). If Windows Firewall is in use on the cluster nodes and the rule group isn't enabled, the
280+
Updating Run will fail. The Remote Shutdown Windows Firewall rule group isn't enabled when it will
281281
conflict with Group Policy settings that are configured for Windows Firewall.
282282
283283
```yaml
@@ -441,7 +441,7 @@ begins, and before the node is put into Maintenance mode. The file name extensio
441441
the total length of the path plus the file name must be no longer than 260 characters. As a best
442442
practice, the script should be located on a disk in cluster storage, or at a highly available
443443
network share, to ensure that the script is always accessible to all the cluster nodes. If a
444-
pre-update script fails, the node is not updated.
444+
pre-update script fails, the node isn't updated.
445445
446446
```yaml
447447
Type: String
@@ -456,7 +456,7 @@ Accept wildcard characters: False
456456
```
457457
458458
### -RebootTimeoutMinutes
459-
Specifies the time in minutes that CAU allows for the restarting of a node. If the restart does not
459+
Specifies the time in minutes that CAU allows for the restarting of a node. If the restart doesn't
460460
complete within this time, then the Updating Run on that node will be marked as failed.
461461
462462
```yaml
@@ -490,11 +490,11 @@ Accept wildcard characters: False
490490
### -RunPluginsSerially
491491
Indicates that the cmdlet CAU scans each cluster node for applicable updates and stages the updates
492492
for each plug-in in the plug-in order when multiple plug-ins are used during an Updating Run when
493-
you use the *CauPluginName* parameter. By default, CAU scans and stages the applicable updates for
493+
you use the **CauPluginName** parameter. By default, CAU scans and stages the applicable updates for
494494
all plug-ins in parallel. Regardless of the configuration of this parameter, CAU installs the
495495
applicable updates for each plug-in sequentially.
496496
497-
The parameter is valid only when multiple plug-ins are specified in the *CauPluginName* parameter.
497+
The parameter is valid only when multiple plug-ins are specified in the **CauPluginName** parameter.
498498
If a single plug-in is specified, a warning appears.
499499
500500
```yaml
@@ -515,7 +515,7 @@ updates on the node, if the installation of an update by a plug-in requires a re
515515
during an updating run, all plug-ins complete the installation of updates on a cluster node before
516516
the node restarts one time.
517517
518-
The parameter is valid only when multiple plug-ins are specified in the *CauPluginName* parameter.
518+
The parameter is valid only when multiple plug-ins are specified in the **CauPluginName** parameter.
519519
If a single plug-in is specified, a warning appears.
520520
521521
```yaml
@@ -546,7 +546,7 @@ Accept wildcard characters: False
546546
```
547547
548548
### -StopAfter
549-
Specifies the time in minutes after which the updating run is canceled if it has not completed. The
549+
Specifies the time in minutes after which the updating run is canceled if it hasn't completed. The
550550
time span can be expressed in the standard ways available in Windows PowerShell, for instance,
551551
`01:30:00` represents one hour and thirty minutes. By default, the updating run is allowed an
552552
unlimited amount of time to complete.
@@ -568,9 +568,8 @@ Accept wildcard characters: False
568568

569569
### -StopOnPluginFailure
570570
Indicates that this cmdlet coordinates subsequent updates on the node when plug-ins are stopped.
571-
When multiple plug-ins are used during an updating run, by default, a failure by one plug-in does
572-
not affect the application of updates on a node by other plug-ins. This parameter is valid only when
573-
multiple plug-ins are specified in the *CauPluginName* parameter. If a single plug-in is specified,
571+
When multiple plug-ins are used during an updating run, by default, a failure by one plug-in doesn't affect the application of updates on a node by other plug-ins. This parameter is valid only when
572+
multiple plug-ins are specified in the **CauPluginName** parameter. If a single plug-in is specified,
574573
a warning appears.
575574

576575
```yaml
@@ -586,12 +585,12 @@ Accept wildcard characters: False
586585
```
587586

588587
### -SuspendClusterNodeTimeoutMinutes
589-
Specifies the maximum amount of time CAU should wait for the **Suspend-ClusterNode** cmdlet to
588+
Specifies the maximum amount of time CAU should wait for the `Suspend-ClusterNode` cmdlet to
590589
succeed if the underlying clustered space is in degraded condition.
591590

592-
If **Suspend-ClusterNode** fails with ERROR_CLUSTER_SPACE_DEGRADED error, CAU will keep retrying for
593-
*SuspendClusterNodeTimeoutMinutes* or suspend the call if the command succeeds. The retries for this
594-
error don not count towards the *MaxRetriesPerNode* parameter set by the user.
591+
If `Suspend-ClusterNode` fails with ERROR_CLUSTER_SPACE_DEGRADED error, CAU will keep retrying for
592+
**SuspendClusterNodeTimeoutMinutes** or suspend the call if the command succeeds. The retries for this
593+
error don't count towards the **MaxRetriesPerNode** parameter set by the user.
595594

596595
The timeout value is per cluster node. So CAU could potentially spend the amount of time specified
597596
for this value for every node in the cluster in the worst case.
@@ -630,7 +629,7 @@ Accept wildcard characters: False
630629

631630
### -WarnAfter
632631
Specifies the time in minutes after which a warning will be logged if the Updating Run (including
633-
any pre-update and post-update scripts) has not completed. By default, no warning will be logged,
632+
any pre-update and post-update scripts) hasn't completed. By default, no warning will be logged,
634633
regardless of the time taken by the Updating Run.
635634

636635
```yaml
@@ -663,7 +662,7 @@ Accept wildcard characters: False
663662

664663
### -WhatIf
665664
Shows what would happen if the cmdlet runs.
666-
The cmdlet is not run.
665+
The cmdlet isn't run.
667666

668667
```yaml
669668
Type: SwitchParameter

docset/winserver2022-ps/clusterawareupdating/Disable-CauClusterRole.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
description: Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
33
external help file: ClusterAwareUpdating.dll-Help.xml
44
Module Name: ClusterAwareUpdating
5-
ms.date: 12/20/2016
5+
ms.date: 09/27/2022
66
online version: https://learn.microsoft.com/powershell/module/clusterawareupdating/disable-cauclusterrole?view=windowsserver2022-ps&wt.mc_id=ps-gethelp
77
schema: 2.0.0
88
title: Disable-CauClusterRole
@@ -21,9 +21,9 @@ Disable-CauClusterRole [[-ClusterName] <String>] [-Credential <PSCredential>] [-
2121
```
2222

2323
## DESCRIPTION
24-
The **Disable-CauClusterRole** cmdlet suspends the self-updating functionality on the specified
24+
The `Disable-CauClusterRole` cmdlet suspends the self-updating functionality on the specified
2525
cluster. The self-updating functionality of the cluster can be re-enabled with the
26-
**Enable-CauClusterRole** cmdlet.
26+
`Enable-CauClusterRole` cmdlet.
2727

2828
## EXAMPLES
2929

@@ -34,13 +34,13 @@ PS C:\> Disable-CauClusterRole -ClusterName CONTOSO-FC1 -Force
3434

3535
This command prevents the CAU clustered role on the CONTOSO-FC1 cluster from performing Updating
3636
Runs. The cmdlet changes the status of the CAU clustered role to Offline. Because the command
37-
specified the *Force* parameter, the cmdlet runs without displaying confirmation prompts.
37+
specified the **Force** parameter, the cmdlet runs without displaying confirmation prompts.
3838

3939
## PARAMETERS
4040

4141
### -ClusterName
4242
Specifies the name of the cluster on which to disable the self-updating functionality. This
43-
parameter is only required when this cmdlet is not run on a failover cluster node, or this cmdlet is
43+
parameter is only required when this cmdlet isn't run on a failover cluster node, or this cmdlet is
4444
used to reference a failover cluster different from where the cmdlet is run.
4545

4646
```yaml
@@ -102,7 +102,7 @@ Accept wildcard characters: False
102102
103103
### -WhatIf
104104
Shows what would happen if the cmdlet runs.
105-
The cmdlet is not run.
105+
The cmdlet isn't run.
106106
107107
```yaml
108108
Type: SwitchParameter

docset/winserver2022-ps/clusterawareupdating/Enable-CauClusterRole.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
description: Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
33
external help file: ClusterAwareUpdating.dll-Help.xml
44
Module Name: ClusterAwareUpdating
5-
ms.date: 12/20/2016
5+
ms.date: 09/27/2022
66
online version: https://learn.microsoft.com/powershell/module/clusterawareupdating/enable-cauclusterrole?view=windowsserver2022-ps&wt.mc_id=ps-gethelp
77
schema: 2.0.0
88
title: Enable-CauClusterRole
@@ -21,9 +21,9 @@ Enable-CauClusterRole [[-ClusterName] <String>] [-Credential <PSCredential>] [-F
2121
```
2222

2323
## DESCRIPTION
24-
The **Enable-CauClusterRole** cmdlet re-enables the self-updating functionality on the specified
24+
The `Enable-CauClusterRole` cmdlet re-enables the self-updating functionality on the specified
2525
cluster. The self-updating functionality of the cluster can be disabled with the
26-
**Disable-CauClusterRole** cmdlet.
26+
`Disable-CauClusterRole` cmdlet.
2727

2828
## EXAMPLES
2929

@@ -34,13 +34,13 @@ PS C:\> Enable-CauClusterRole -ClusterName "CONTOSO-FC1" -Force
3434

3535
This command enables the CAU clustered role on the CONTOSO-FC1 cluster to begin performing Updating
3636
Runs. The cmdlet changes the status of the CAU clustered role to Running. Because the command
37-
specified the *Force* parameter, the cmdlet runs without displaying confirmation prompts.
37+
specified the **Force** parameter, the cmdlet runs without displaying confirmation prompts.
3838

3939
## PARAMETERS
4040

4141
### -ClusterName
4242
Specifies the name of the cluster on which to enable the self-updating functionality. This parameter
43-
is only required when this cmdlet is not run on a failover cluster node, or this cmdlet is used to
43+
is only required when this cmdlet isn't run on a failover cluster node, or this cmdlet is used to
4444
reference a failover cluster different from where the cmdlet is run.
4545

4646
```yaml
@@ -102,7 +102,7 @@ Accept wildcard characters: False
102102
103103
### -WhatIf
104104
Shows what would happen if the cmdlet runs.
105-
The cmdlet is not run.
105+
The cmdlet isn't run.
106106
107107
```yaml
108108
Type: SwitchParameter

docset/winserver2022-ps/clusterawareupdating/Export-CauReport.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
description: Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
33
external help file: ClusterAwareUpdating.dll-Help.xml
44
Module Name: ClusterAwareUpdating
5-
ms.date: 12/20/2016
5+
ms.date: 09/27/2022
66
online version: https://learn.microsoft.com/powershell/module/clusterawareupdating/export-caureport?view=windowsserver2022-ps&wt.mc_id=ps-gethelp
77
schema: 2.0.0
88
title: Export-CauReport
@@ -21,13 +21,13 @@ Export-CauReport [-InputReport] <CauReport[]> [-Format] <OutputType> [-Path] <St
2121
```
2222

2323
## DESCRIPTION
24-
The **Export-CauReport** cmdlet exports one or more Updating Run reports into an HTML or
24+
The `Export-CauReport` cmdlet exports one or more Updating Run reports into an HTML or
2525
CSV-formatted document. Each Run report summarizes both the node-level and cluster-level summary
2626
status for the Updating Run.
2727

28-
Pipe one or more reports from the **Get-CauReport** cmdlet with the *Detailed* parameter, and
29-
control the content in the report by specifying appropriate parameters for the **Get-CauReport**
30-
cmdlet. For example, the *Last* parameter specifies the most recent Updating Run.
28+
Pipe one or more reports from the `Get-CauReport` cmdlet with the **Detailed** parameter, and
29+
control the content in the report by specifying appropriate parameters for the `Get-CauReport`
30+
cmdlet. For example, the **Last** parameter specifies the most recent Updating Run.
3131

3232
## EXAMPLES
3333

@@ -91,7 +91,7 @@ Accept wildcard characters: False
9191
9292
### -InputReport
9393
Specifies an array of CAU report objects, such as generated from a call to Get-CauReport with the
94-
*Detailed* parameter.
94+
**Detailed** parameter.
9595
9696
```yaml
9797
Type: CauReport[]
@@ -107,7 +107,7 @@ Accept wildcard characters: False
107107
108108
### -PassThru
109109
Returns an object representing the item with which you are working.
110-
By default, this cmdlet does not generate any output.
110+
By default, this cmdlet doesn't generate any output.
111111
112112
```yaml
113113
Type: SwitchParameter
@@ -153,7 +153,7 @@ Accept wildcard characters: False
153153
154154
### -WhatIf
155155
Shows what would happen if the cmdlet runs.
156-
The cmdlet is not run.
156+
The cmdlet isn't run.
157157
158158
```yaml
159159
Type: SwitchParameter

0 commit comments

Comments
 (0)