Add-CMFallbackStatusPoint

Adds a fallback status point to a Configuration Manager site.

Syntax

Add-CMFallbackStatusPoint
   [-StateMessageNum <Int32>]
   [-ThrottleSec <Int32>]
   [-ThrottleMins <Int32>]
   -InputObject <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMFallbackStatusPoint
   [-SiteSystemServerName] <String>
   [-SiteCode <String>]
   [-StateMessageNum <Int32>]
   [-ThrottleSec <Int32>]
   [-ThrottleMins <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Add-CMFallbackStatusPoint cmdlet adds a fallback status point to a Microsoft System Center 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 on TechNet.

Examples

Example 1: Add a fallback status point

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

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.

Required Parameters

-InputObject

Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet.

Type:IResultObject
Aliases:SiteServer
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-SiteSystemServerName

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

Type:String
Aliases:Name, ServerName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteCode

Specifies the site code for a Configuration Manager site.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StateMessageNum

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ThrottleMins
Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ThrottleSec
Type:Int32
Aliases:ThrottleIntervalSeconds, ThrottleInterval
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False