Edit

Get-CMBoundary

  • Reference
Module:
ConfigurationManager

Get a site boundary.

Syntax

Get-CMBoundary
   [-BoundaryName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMBoundary
   -BoundaryGroupId <UInt32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMBoundary
   -BoundaryGroupInputObject <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMBoundary
   -BoundaryGroupName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
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.

Type:UInt32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:IResultObject
Aliases:BoundaryGroup
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BoundaryGroupName

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

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

-BoundaryId

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

Type:UInt32
Aliases:Id
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BoundaryName

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

Inputs

None

Outputs

IResultObject[]

IResultObject