Edit

Share via


Get-CMBoundary

Get a site boundary.

Syntax

SearchByName (Default)

Get-CMBoundary
    [-BoundaryName <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

SearchByBoundaryGroupIdMandatory

Get-CMBoundary
    -BoundaryGroupId <UInt32>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

SearchByBoundaryGroup

Get-CMBoundary
    -BoundaryGroupInputObject <IResultObject>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

SearchByBoundaryGroupNameMandatory

Get-CMBoundary
    -BoundaryGroupName <String>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

SearchByIdMandatory

Get-CMBoundary
    -BoundaryId <UInt32>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

Description

The Get-CMBoundary cmdlet gets a Configuration Manager boundary.

In Configuration Manager, a boundary is a network ___location that contains one or more devices that you can manage. A boundary can be an IP subnet, Active Directory site name, IPv6 prefix, IP address range, or VPN.

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 by its ID

This command gets a boundary that's specified by the ID 67777217.

PS XYZ:\> Get-CMBoundary -Id "67777217"
BoundaryFlags:      0
BoundaryID:         67777217
BoundaryType:       1
CreatedBy:          Contoso\PFuller
CreatedOn           6/10/2012 2:58:56 PM
DefaultSiteCode:
DisplayName:
GroupCount:         0
ModifiedBy:         Contoso\PFuller
ModifiedOn:         9/13/2012  10:04 AM
SiteSystems:
Value:              Default1

Example 2: Get a boundary by the name of an associated boundary group

This command gets a boundary that's specified by the associated boundary group BGroup07.

Get-CMBoundary -BoundaryGroupName "BGroup07"

Parameters

-BoundaryGroupId

Specify the ID of a boundary group that includes the boundary to get. You can get a boundary group ID by using the Get-CMBoundaryGroup cmdlet. This ID is the GroupID property on the SMS_BoundaryGroup object. For example, 33.

Parameter properties

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

Parameter sets

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

-BoundaryGroupInputObject

Specify an object for a boundary group that includes the boundary to get. You can get this object by using the Get-CMBoundaryGroup cmdlet.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False
Aliases:BoundaryGroup

Parameter sets

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

-BoundaryGroupName

Specify the name of a boundary group that includes the boundary to get.

Parameter properties

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

Parameter sets

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

-BoundaryId

Specify the ID of the boundary to get. This ID is the BoundaryID property on the SMS_Boundary object. For example, 23.

Parameter properties

Type:UInt32
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Id

Parameter sets

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

-BoundaryName

Specify the name of the boundary to get. This name is the DisplayName property on the SMS_Boundary object.

Parameter properties

Type:String
Default value:None
Supports wildcards:True
DontShow:False
Aliases:DisplayName, Name

Parameter sets

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

-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

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