Set-SCComplianceStatus

Set-SCComplianceStatus

Modifies a compliance status object.

Syntax

Parameter Set: Default
Set-SCComplianceStatus [-ComplianceStatus] <ComplianceStatus> -Baseline <Baseline> -Update <SoftwareUpdate> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: AddExemption
Set-SCComplianceStatus [-ComplianceStatus] <ComplianceStatus> -AddExemption -Baseline <Baseline> -Update <SoftwareUpdate> [-ExemptionNote <String> ] [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: RemoveExemption
Set-SCComplianceStatus [-ComplianceStatus] <ComplianceStatus> -Baseline <Baseline> -RemoveExemption -Update <SoftwareUpdate> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Detailed Description

The Set-SCComplianceStatus cmdlet modifies a compliance status object.

Parameters

-AddExemption

Indicates that this cmdlet adds an exemption to an update that is part of a baseline.

Aliases

none

Required?

true

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?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-ComplianceStatus<ComplianceStatus>

Specifies a compliance status object. The compliance status of an object indicates its compliance to the baselines to which the object is assigned.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-ExemptionNote<String>

Specifies a business reason for the exempted update.

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

-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

-RemoveExemption

Removes an exemption from an update that is part of a baseline.

Aliases

none

Required?

true

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

-Update<SoftwareUpdate>

Specifies a software update object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

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.

  • ComplianceStatus

Examples

Example 1: Add an exemption to a compliance status

The first command gets the host object named VMHost01, and then stores the object in the $VMHost variable.

The second command gets the compliance status for VMHost01, and then stores the status object in the $Compliance variable.

The third command gets the baseline named Security Baseline, and then stores the object in the $Baseline variable.

The fourth command gets the security bulletin update MS05-055, and then stores the update object in the $Update variable.

The last command adds an exemption to the update MS05-055 that is part of the Security Baseline baseline, and an exemption note with a business reason for the exemption.

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> $Compliance = Get-SCComplianceStatus -VMMManagedComputer $VMHost.ManagedComputer
PS C:\> $Baseline = Get-SCBaseline -Name "Security Baseline"
PS C:\> $Update = Get-SCUpdate -SecurityBulletinID "MS05-055"
PS C:\> Set-SCComplianceStatus -ComplianceStatus $Compliance -Baseline $Baseline -Update $Update -AddExemption -ExemptionNote "This exemption has been signed off by the IT Manager."

Get-SCComplianceStatus

Get-SCVMHost

Get-SCBaseline

Get-SCUpdate