Get-CMBoundary
Get-CMBoundary
Gets a boundary.
Syntax
Parameter Set: SearchByName
Get-CMBoundary [-Name <String[]> ] [ <CommonParameters>]
Parameter Set: SearchByBoundaryGroup
Get-CMBoundary -BoundaryGroup <IResultObject> [ <CommonParameters>]
Parameter Set: SearchByBoundaryGroupIdMandatory
Get-CMBoundary -BoundaryGroupId <String> [ <CommonParameters>]
Parameter Set: SearchByBoundaryGroupNameMandatory
Get-CMBoundary -BoundaryGroupName <String> [ <CommonParameters>]
Parameter Set: SearchByIdMandatory
Get-CMBoundary -Id <String[]> [ <CommonParameters>]
Detailed Description
The Get-CMBoundary cmdlet gets a boundary.
In Microsoft System Center 2012 SP1 Configuration Manager, a boundary is an intranet location that contains one or more devices that you can manage. A boundary can be an IP subnet, Active Directory site name, IPv6 prefix, or an IP address range.
Parameters
-BoundaryGroup<IResultObject>
Specifies an input object to this cmdlet, which in this case is a boundary group (a collection of boundaries). You can get a boundary group object by using the Get-CMBoundaryGroup cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-BoundaryGroupId<String>
Specifies an identifier (ID) for a boundary group. You can get a boundary group ID by using the Get-CMBoundaryGroup cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-BoundaryGroupName<String>
Specifies a name for a boundary group. You can get a boundary group name by using the Get-CMBoundaryGroup cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Id<String[]>
Specifies an array of boundary IDs.
Aliases |
BoundaryId |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Name<String[]>
Specifies an array of boundary names.
Aliases |
DisplayName |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Get a boundary that is specified by its identifier.
This command gets a boundary that is specified by the identifier 67777217.
PS C:\> Get-Boundary -Id "67777217"
Example 2: Get a boundary that is specified by the name of an associated boundary group
This command gets a boundary that is specified by the associated boundary group BGroup07.
PS C:\> Get-Boundary -BoundaryGroupName "BGroup07"