Edit

Share via


Register-CauPlugin

Registers a CAU software updating plug-in on the local computer.

Syntax

Default (Default)

Register-CauPlugin
    [-Path] <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Register-CauPlugin cmdlet registers a Cluster-Aware Updating (CAU) software updating plug-in on the local computer.

CAU always uses a plug-in when performing updates, although you don't need to register a plug-in because CAU uses the Microsoft.WindowsUpdatePlugin plug-in by default. This plug-in communicates with the Windows Update Agent software resident on each node, the same software that is used when updates are downloaded from Windows Update or Microsoft Update, or from a Windows Server Update Services (WSUS) server. For more information about how plug-ins work in CAU, see How CAU Plug-ins Work.

Examples

Example 1: Register a specific plug-in located in the specified folder

Register-CauPlugin -Path "C:\PluginDevelopment\Plugin01.dll" -Force

The command registers a plug-in called Plugin01.dll located in the C:\PluginDevelopment folder. Because the command specifies the Force parameter, the cmdlet runs without displaying confirmation prompts.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Path

Specifies the path to the binary that implements the plug-in. Classes that implement the plug-in interface and are decorated with the plug-in attribute, are discovered through reflection and registered.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet isn't run.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

Microsoft.ClusterAwareUpdating.CauPlugin