Set-​CM​Boundary​Group

Modifies the properties of a boundary group.

Syntax

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

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
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
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Name

Specifies a name for a boundary group.

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

{{Fill AddSiteSystemServerName Description}}

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

Specifies a description for a boundary group.

Type:String
Position:Named
Default value:None
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

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
-NewName

Specifies a new name for a boundary group.

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

Returns the current working object. By default, this cmdlet does not generate any output.

Type:SwitchParameter
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
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
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