Set-CMBoundaryGroup

Modifies the properties of a boundary group.

Syntax

Set-CMBoundaryGroup
   [-AddSiteSystemServer <Hashtable>]
   [-ClearSiteSystemServer]
   [-Confirm]
   [-DefaultSiteCode <String>]
   [-Description <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -Id <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveSiteSystemServer <IResultObject[]>]
   [-RemoveSiteSystemServerName <String[]>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMBoundaryGroup [-AddSiteSystemServer ] [-ClearSiteSystemServer] [-Confirm]
 [-DefaultSiteCode ] [-Description ] [-DisableWildcardHandling] [-ForceWildcardHandling]
 -InputObject  [-NewName ] [-PassThru] [-RemoveSiteSystemServer ]
 [-RemoveSiteSystemServerName ] [-WhatIf] []
Set-CMBoundaryGroup [-AddSiteSystemServer ] [-ClearSiteSystemServer] [-Confirm]
 [-DefaultSiteCode ] [-Description ] [-DisableWildcardHandling] [-ForceWildcardHandling]
 -Name  [-NewName ] [-PassThru] [-RemoveSiteSystemServer ]
 [-RemoveSiteSystemServerName ] [-WhatIf] []

Description

The Set-CMBoundaryGroup cmdlet modifies the properties of a boundary group. A boundary group is a collection of boundaries. For more information about boundaries, see Planning for Boundaries and Boundary Groups in Configuration Manager on TechNet and the New-CMBoundary cmdlet.

Examples

Example 1: Rename a boundary group

PS C:\> Set-CMBoundaryGroup -Name "BGroup01" -NewName "BGroup00"

This command renames a boundary group.

Example 2: Add a security scope to a boundary group

PS C:\> Set-CMBoundaryGroup -SecurityScopeAction AddMembership -SecurityScopeName "OSDeploymentScope" -Name "BGroup02"

This command adds the security scope OSDeploymentScope to the boundary group BGroup02.

Required Parameters

-Id

Specifies an array of identifiers for one or more boundary groups.

Type:String
Aliases:GroupId
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

Specifies a boundary group object. To obtain a boundary group object, use the Get-CMBoundaryGroup cmdlet.

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Name

Specifies a name for a boundary group.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AddSiteSystemServer

Specifies the site system server and link speed as the key/value pair in a hash table. Valid values are:- FastLink

  • Slowlink

    For example: @{"Server01.contoso.com" = "FastLink"}

    Important: Starting in version 1610, FastLink is the only supported value for the hash table.
Type:Hashtable
Aliases:AddSiteSystemServers
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ClearSiteSystemServer

Indicates that the site system server is removed from the boundary group.

Type:SwitchParameter
Aliases:ClearSiteSystemServers
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

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

Specifies the default site code of a boundary group.

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

Specifies a description for a boundary group.

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

Indicates that wildcard handling is disabled.

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

Indicates that wildcard handling is disabled.

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

Specifies a new name for a boundary group.

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

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

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

Specifies a site system server object to remove from the boundary group. To obtain a site system server, use the Get-CMSiteSystemServer cmdlet.

Type:IResultObject[]
Aliases:RemoveSiteSystemServers
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveSiteSystemServerName

Specifies the name of a site system server to remove from the boundary group.

Type:String[]
Aliases:RemoveSiteSystemServerNames
Required:False
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
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False