Add-CMFallbackStatusPoint

Add-CMFallbackStatusPoint

Adds a fallback status point to a Configuration Manager site.

Syntax

Parameter Set: FallbackStatusPoint
Add-CMFallbackStatusPoint -SiteCode <String> -SiteSystemServerName <String> -StateMessageNum <Int32> -ThrottleInterval <Int32> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Add-CMFallbackStatusPoint cmdlet adds a fallback status point to a Microsoft System Center 2012 SP1 Configuration Manager site. To add this site system role, specify the site code for the Configuration Manager site and the name of the computer that hosts the role. You also need to specify a throttle interval and the number of messages for that throttle window.

Configuration Manager can use one or more fallback status points to collect state messages for a site and send them to Configuration Manager. Throttling prevents the fallback status point from sending too many messages together, which can affect performance. For more information about site system roles, see Install and Configure Site System Roles for Configuration Manager (https://go.microsoft.com/fwlink/?LinkId=262649) on TechNet.

Parameters

-SiteCode<String>

Specifies the site code for a Configuration Manager site.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteSystemServerName<String>

Specifies the name of a server that hosts a site system role.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-StateMessageNum<Int32>

Specifies the number of state messages that a fallback status point can send to Configuration Manager within a throttle interval.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ThrottleInterval<Int32>

Specifies the throttle interval, in minutes, for a fallback status point. Configuration Manager processes a limited number of state messages during this period.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

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.

Examples

Example 1: Add a fallback status point

This command adds a fallback status point for the site that has the site code CM1. The specified computer hosts the role. The command also specifies number of messages and throttle time period for the fallback status point.

PS C:\> Add-CMFallbackStatusPoint -SiteCode "CM1" -SiteSystemServerName "CMFSPPoint.Western.Contoso.com" -StateMessageNum 10000 -ThrottleInterval 60

Get-CMFallbackStatusPoint

Remove-CMFallbackStatusPoint

Set-CMFallbackStatusPoint