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.