Share via


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"

Get-CMBoundary

Get-CMBoundaryGroup

Remove-CMBoundaryFromGroup