Set-CMSystemHealthValidatorPointComponent

Set-CMSystemHealthValidatorPointComponent

Modifies settings of a Configuration Manager system health validator point.

構文

Parameter Set: SearchBySiteCodeMandatory
Set-CMSystemHealthValidatorPointComponent -SiteCode <String> [-Date <DateTime> ] [-DesignateActiveDirectoryForest <Boolean> ] [-DomainSuffix <String> ] [-PublishAccount <String> ] [-QueryAccount <String> ] [-QueryInterval <Int32> ] [-Time <DateTime> ] [-UseDateTime <Boolean> ] [-ValidityPeriod <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByNameMandatory
Set-CMSystemHealthValidatorPointComponent -Name <String> [-Date <DateTime> ] [-DesignateActiveDirectoryForest <Boolean> ] [-DomainSuffix <String> ] [-PublishAccount <String> ] [-QueryAccount <String> ] [-QueryInterval <Int32> ] [-Time <DateTime> ] [-UseDateTime <Boolean> ] [-ValidityPeriod <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Set-CMSystemHealthValidatorPointComponent -InputObject <IResultObject> [-Date <DateTime> ] [-DesignateActiveDirectoryForest <Boolean> ] [-DomainSuffix <String> ] [-PublishAccount <String> ] [-QueryAccount <String> ] [-QueryInterval <Int32> ] [-Time <DateTime> ] [-UseDateTime <Boolean> ] [-ValidityPeriod <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Set-CMSystemHealthValidatorPointComponent cmdlet modifies settings of a system health validator point. A system health validator point is a Microsoft System Center 2012 Configuration Manager site system role that evaluates system health information reported by Windows clients for security related compliance.

You can modify whether the system health validator point uses the current Active Directory forest or a designated forest. You can specify the accounts that the component uses to publish and query Active Directory Domain Services (AD DS). You can set the validity period for cached statements of health and whether to accept statements of health only after a specific time. Any changes you make apply to all system health validator points in the System Center 2012 Configuration Manager site.

To specify a system health validator point to modify, specify a site code or name, or you can use the Get-CMSystemHealthValidatorPointComponent cmdlet to get a system health validator point to modify.

パラメーター

-Date<DateTime>

Specifies a date, as a DateTime object. To obtain a DateTime object, use the Get-Date cmdlet. For more information, type Get-Help Get-Date.

If you specify a value of $True for the UseDateTime parameter, a client must create a statement of health after the date and time specified by using this parameter and the Time parameter. The date and time must be in the past.

-DesignateActiveDirectoryForest<Boolean>

Indicates whether the site system server and the system health validator points are in different Active Directory forests. If the value is $True, specify an Active Directory forest by using the DomainSuffix parameter. If no trust relationship exists between the forests, you may need to specify accounts by using the PublishAccount and QueryAccount parameters.

-DomainSuffix<String>

Specifies a domain suffix for a designated Active Directory forest. If no trust relationship exists between this forest and the site system server forest, you may need to specify accounts by using the PublishAccount and QueryAccount parameters.

-InputObject<IResultObject>

Specifies a system health validator point object. To obtain a system health validator point, use the Get-CMSystemHealthValidatorPointComponent cmdlet.

-Name<String>

Specifies the name of a system health validator point.

-PublishAccount<String>

Specifies a health state reference publishing account, in the format Domain\User. If you do not specify an account, the component uses the site system server account.

You must specify an account if no trust relationship exists between the site server domain and the domain suffix specified in the DomainSuffix parameter or if there is a trust relationship, but the site system server account lacks Full Control permission for the System Management Active Directory container.

-QueryAccount<String>

Specifies an account, in the format Domain\User, that the system health validator point uses to query AD DS for state references. If you do not specify an account, the component uses the site system server account.

You must specify an account if no trust relationship exists between the site server domain and the domain suffix specified in the DomainSuffix parameter.

-QueryInterval<Int32>

Specifies how often, in minutes, system health validator points get health state references. Valid values are: 1 to 10080 minutes (7 days). The default value is 120 minutes.

-SiteCode<String>

Specifies a site code in Configuration Manager.

-Time<DateTime>

Specifies a time, as a DateTime object. To obtain a DateTime object, use the Get-Date cmdlet.

If you specify a value of $True for the UseDateTime parameter, a client must create a statement of health after the date and time specified by using this parameter and the Date parameter. The date and time must be in the past.

-UseDateTime<Boolean>

Indicates whether a client must create a statement of health after a specific date and time. If you select a value of $True, specify the date and time by using the Date and Time parameters. The date and time must be in the past. The default value for this parameter is $False.

-ValidityPeriod<Int32>

Specifies the length of time, in hours, for which system health validator points accept a cached client statement of health. Valid values are: 1 to 168 hours (7 days). The default value is 26 hours.

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Modify settings of a system health validator point by using a name

This command modifies settings of a system health validator point named SHVPC02.Western.Contoso.com. The command changes the query interval to 60 minutes and the validity period to 24 hours.

PS C:\> Set-CMSystemHealthValidatorPointComponent -Name "SHVPC02.Western.Contoso.com" -QueryInterval 60 -ValidityPeriod 24

関連トピック

Get-CMSystemHealthValidatorPointComponent

Set-CMCollectionMembershipEvaluationComponent

Set-CMEmailNotificationComponent

Set-CMManagementPointComponent

Set-CMOutOfBandManagementComponent

Set-CMSoftwareUpdatePointComponent

Set-CMStatusReportingComponent