Edit

Share via


Get-CMBoundaryGroup

Get a boundary group.

Syntax

SearchByName (Default)

Get-CMBoundaryGroup
    [-Name <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

SearchByIdMandatory

Get-CMBoundaryGroup
    -Id <String[]>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

Description

Use the Get-CMBoundaryGroup cmdlet to get a boundary group. A boundary group is a collection of boundaries.

You can use boundary groups to manage network locations. Before you can use the boundary group, assign boundaries to boundary groups . Boundary groups enable client computers to find a primary site for client assignment, and a list of available site systems that have content. For more information about boundaries, see Overview of boundaries and boundary groups in Configuration Manager.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Get a boundary group that is specified by its name

This command gets a boundary group that is specified by the name BGroup01.

Get-CMBoundaryGroup -Name "BGroup01"

Example 2: Get multiple boundary groups that are specified by ID

This command gets multiple boundary groups that are specified by the identifiers 5 and 6.

Get-CMBoundaryGroup -Id 5,6

Parameters

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Id

Specify an array of group IDs for one or more boundary groups. This value is an integer, for example 5.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:GroupId

Parameter sets

SearchByIdMandatory
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specify the name for a boundary group.

Parameter properties

Type:String
Default value:None
Supports wildcards:True
DontShow:False

Parameter sets

SearchByName
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

IResultObject

IResultObject

Notes

For more information on this return object and its properties, see SMS_BoundaryGroup server WMI class.