Set-SCBaseline
Set-SCBaseline
Modifies a baseline by adding or removing updates or assignment scopes.
Syntax
Parameter Set: Default
Set-SCBaseline [-Baseline] <Baseline> [-AddAssignmentScope <IBaselineAssignmentScope> ] [-AddUpdates <List`1> ] [-Description <String> ] [-JobGroup <Guid]> ] [-JobVariable <String> ] [-Name <String> ] [-PROTipID <Guid]> ] [-RemoveAssignmentScope <IBaselineAssignmentScope> ] [-RemoveUpdates <List`1> ] [-RunAsynchronously] [-StartNow] [-VMMServer <ServerConnection> ] [ <CommonParameters>]
Detailed Description
The Set-SCBaseline cmdlet modifies a baseline by adding or removing updates or assignment scopes. A baseline is a list of updates which, together with scope assignments, can grade the compliance of required updates for Virtual Machine Manager (VMM) fabric servers.
Parameters
-AddAssignmentScope<IBaselineAssignmentScope>
Adds one or more virtual machine hosts or clusters to a baseline assignment scope.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-AddUpdates<List`1>
Adds one or more software updates to a baseline.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Baseline<Baseline>
Specifies a VMM baseline object.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-Description<String>
States a description for the specified object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-JobGroup<Guid]>
Specifies an identifier for a series of commands that will run as a set just before the final command that includes the same job group identifier runs.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-JobVariable<String>
Specifies that job progress is tracked and stored in the variable named by this parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies the name of a VMM object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PROTipID<Guid]>
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-RemoveAssignmentScope<IBaselineAssignmentScope>
Removes one or more VMMManagedComputer, VMHostCluster, or VMHostGroup objects from a baseline assignment scope.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-RemoveUpdates<List`1>
Removes one or more software updates from a baseline.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-StartNow
Identifies the last command of a jobgroup and starts running the commands within the jobgroup. This parameter must be used with the JobGroup parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-VMMServer<ServerConnection>
Specifies a VMM server object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
- Baseline
Examples
Example Example 1: Modify an existing baseline by adding updates and an assignment scope.s
The first command gets the cluster object named Cluster01, and then stores the object in the $Cluster variable.
The second command gets the baseline object named Security Baseline, and then stores the object in the $Baseline variable.
The third command gets the security bulletin update object named MS05-051, and then stores the object in the $Update variable.
The last command adds the update stored in $Update to the baseline stored in $Baseline and sets the assignment scope to the object stored in $Cluster.
PS C:\> $Cluster = Get-SCVMHostCluster -Name "Cluster01"
PS C:\> $Baseline = Get-SCBaseline -Name "Security Baseline"
PS C:\> $Update = Get-SCUpdate -SecurityBulletinId "MS05-055"
PS C:\> Set-SCBaseline -Baseline $Baseline -AddUpdates $Update -AddAssignmentScope $Cluster
Example 2: Remove an update and an assignment scope from an existing baseline
The first command gets the cluster object named Cluster01, and then stores the object in the $Cluster variable.
The second command gets the baseline object named Security Baseline, and then stores the object in the $Baseline variable.
The third command gets the security bulletin update object named MS05-051, and stores the object in the $Update variable.
The last command removes the update stored in $Update from the baseline stored in $Baseline and removes the assignment scope stored in $Cluster.
PS C:\> $Cluster = Get-SCVMHostCluster -Name "Cluster01"
PS C:\> $Baseline = Get-SCBaseline -Name "Security Baseline"
PS C:\> $Update = Get-SCUpdate -SecurityBulletinId "MS05-055"
PS C:\> Set-SCBaseline -Baseline $Baseline -RemoveUpdates $Update -RemoveAssignmentScope $Cluster