Export (0) Print
Expand All
Expand Minimize

New-CMBoundary

Updated: September 1, 2013

Applies To: System Center 2012 Configuration Manager SP1

New-CMBoundary

Creates a new boundary.

Syntax

Parameter Set: New
New-CMBoundary -Type <BoundaryTypes> {ADSite | IPRange | IPSubnet | IPV6Prefix} -Value <String> [-Name <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The New-CMBoundary cmdlet creates a new boundary.

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.

Parameters

-Name<String>

Specifies the name of the new boundary.


Aliases

DisplayName

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Type<BoundaryTypes>

Specifies a boundary type. Valid values are: IPSubnet or 0, ADSite or 1, IPV6Prefix 2, and IPRange or 3.


Aliases

BoundaryType

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Value<String>

Specifies the data that describes the boundary. For example, an Active Directory site value can be Default-First-Site-Name.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


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.

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: Create a new IP Subnet site boundary

This command creates a new IP subnet site boundary that has a name of IPSubNetBoundary01 and a value of 172.16.50.0/24.


PS C:\> New-CMBoundary -DisplayName "IPSubNetBoundary01" -BoundaryType IPSubNet -Value "172.16.50.0/24"
BoundaryFlags:      0
BoundaryID: 6338009
BoundaryType: 0
CreatedBy: Contoso\BSimon
CreatedOn 6/10/2012 1:17:42 PM
DefaultSiteCode:
DisplayName: IPSubNetBoundary01
GroupCount: 0
ModifiedBy:
ModifiedOn:
SiteSystems:
Value: 172.16.50.0/24

Example 2: Create a new Active Directory site boundary

This command creates a new Active Directory site boundary that has a name of ADSiteBoundary01 and a value of Default-First-Site-Name.


PS C:\> New-CMBoundary -DisplayName "ADSiteBoundary01" -BoundaryType ADSite -Value "Default-First-Site-Name"
BoundaryFlags:      0
BoundaryID: 6339999
BoundaryType: 1
CreatedBy: Contoso\BSimon
CreatedOn 6/10/2012 2:58:56 PM
DefaultSiteCode:
DisplayName: ADSiteBoundary01
GroupCount: 0
ModifiedBy:

SiteSystems:
Value: Default-First-Site-Name

Example 3: Create a new IP v6 prefix site boundary

This command creates a new IP v6 prefix site boundary that has a name of IPv6PrefixBoundary01 and a value of FE80::/64.


PS C:\> New-CMBoundary -DisplayName "IPv6PrefixBoundary01" -BoundaryType IPv6Prefix –Value "FE80::/64".
BoundaryFlags:      0
BoundaryID: 63347110
BoundaryType: 2
CreatedBy: Contoso\BSimon
CreatedOn 6/10/2012 3:15:19 PM
DefaultSiteCode:
DisplayName: IPv6PrefixBoundary01
GroupCount: 0
ModifiedBy:
ModifiedOn:
SiteSystems:
Value: "FE80::/64"

Example 4: Create a new IP range site boundary

This command creates a new IP range site boundary that has the name IPRangeBoundary01 and a value of 10.255.255.0-10.255.255.255.


PS C:\> New-CMBoundary -DisplayName "IPRangeBoundary01" -BoundaryType IPRange -Value "10.255.255.0-10.255.255.255" 
BoundaryFlags:      0
BoundaryID: 6334129
BoundaryType: 3
CreatedBy: Contoso\BSimon
CreatedOn 6/10/2012 3:29:05 PM
DefaultSiteCode:
DisplayName: IPRangeBoundary01
GroupCount: 0
ModifiedBy:
ModifiedOn:
SiteSystems:
Value: 10.255.255.0-10.255.255.255

Related topics

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft