Add-CMBoundaryToGroup
Add-CMBoundaryToGroup
Assigns boundaries to a boundary group.
Syntax
Parameter Set: AddBoundaryToGroupById_Id
Add-CMBoundaryToGroup -BoundaryGroupId <Int32> -BoundaryId <Int32> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddBoundaryToGroupById_Name
Add-CMBoundaryToGroup -BoundaryGroupName <String> -BoundaryId <Int32> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddBoundaryToGroupById_Object
Add-CMBoundaryToGroup -BoundaryGroup <IResultObject> -BoundaryId <Int32> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddBoundaryToGroupByName_Id
Add-CMBoundaryToGroup -BoundaryGroupId <Int32> -BoundaryName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddBoundaryToGroupByName_Name
Add-CMBoundaryToGroup -BoundaryGroupName <String> -BoundaryName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddBoundaryToGroupByName_Object
Add-CMBoundaryToGroup -BoundaryGroup <IResultObject> -BoundaryName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddBoundaryToGroupByObject_Id
Add-CMBoundaryToGroup -Boundary <IResultObject> -BoundaryGroupId <Int32> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddBoundaryToGroupByObject_Name
Add-CMBoundaryToGroup -Boundary <IResultObject> -BoundaryGroupName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddBoundaryToGroupByObject_Object
Add-CMBoundaryToGroup -Boundary <IResultObject> -BoundaryGroup <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Add-CMBoundaryToGroup cmdlet assigns boundaries to a boundary group.
In Microsoft System Center 2012 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.
You can use boundary groups to manage network locations. You must assign boundaries to boundary groups before you can use the boundary group. Boundary groups enable client computers to find a primary site for client assignment (automatic site assignment) and a list of available site systems that have content. For more information about boundaries, see Planning for Boundaries and Boundary Groups in Configuration Manager (https://go.microsoft.com/fwlink/?LinkId=266225) in the TechNet library.
Parameters
-Boundary<IResultObject>
Specifies a boundary object. To obtain a CMBoundary object, use the Get-CMBoundary cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-BoundaryGroup<IResultObject>
Specifies a boundary group object. To obtain a CMBoundaryGroup object, use the Get-CMBoundaryGroup cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-BoundaryGroupId<Int32>
Specifies the ID of a boundary group.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-BoundaryGroupName<String>
Specifies the name of a boundary group.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-BoundaryId<Int32>
Specifies the ID of a boundary.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-BoundaryName<String>
Specifies the name of a boundary.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
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: Assign a boundary group to a boundary
This command assigns the boundary named to CLBound03 to the boundary group that has the Id 16777219.
PS C:\> Add-CMBoundaryToGroup –BoundaryGroupID "16777219" -BoundaryName "CLBound03"