Set-LMCollectorGroup
Syntax
Id
Set-LMCollectorGroup [-Id <Int32>] [-NewName <String>] [-Description <String>] [-Properties <Hashtable>] [-AutoBalance <Boolean>] [-AutoBalanceInstanceCountThreshold <Int32>] [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]
Name
Set-LMCollectorGroup [-Name <String>] [-NewName <String>] [-Description <String>] [-Properties <Hashtable>] [-AutoBalance <Boolean>] [-AutoBalanceInstanceCountThreshold <Int32>] [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]
Description
The Set-LMCollectorGroup function modifies an existing collector group’s settings, including its name, description, properties, and auto-balance settings.
Examples
Example 1
Set-LMCollectorGroup -Id 123 -NewName "Updated Group" -AutoBalance $trueUpdates the collector group with ID 123 with a new name and enables auto-balancing.
Parameters
-Id
Specifies the ID of the collector group to modify. This parameter is mandatory when using the ‘Id’ parameter set.
Type: Int32Parameter Sets: IdAliases:
Required: FalsePosition: NamedDefault value: 0Accept pipeline input: True (ByPropertyName)Accept wildcard characters: False
-Name
Specifies the current name of the collector group. This parameter is mandatory when using the ‘Name’ parameter set.
Type: StringParameter Sets: NameAliases:
Required: FalsePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
-NewName
Specifies the new name for the collector group.
Type: StringParameter Sets: (All)Aliases:
Required: FalsePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
-Description
Specifies a new description for the collector group.
Type: StringParameter Sets: (All)Aliases:
Required: FalsePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
-Properties
Specifies a hashtable of custom properties to set for the collector group.
Type: HashtableParameter Sets: (All)Aliases:
Required: FalsePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
-AutoBalance
Specifies whether to enable auto-balancing for the collector group.
Type: BooleanParameter Sets: (All)Aliases:
Required: FalsePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
-AutoBalanceInstanceCountThreshold
Specifies the threshold for auto-balancing the collector group.
Type: Int32Parameter Sets: (All)Aliases:
Required: FalsePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameterParameter Sets: (All)Aliases: wi
Required: FalsePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameterParameter Sets: (All)Aliases: cf
Required: FalsePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
-ProgressAction
Fill ProgressAction Description
Type: ActionPreferenceParameter Sets: (All)Aliases: proga
Required: FalsePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
You can pipe objects containing Id properties to this function.
Outputs
Returns a LogicMonitor.CollectorGroup object containing the updated group information.
Notes
This function requires a valid LogicMonitor API authentication.