New-CMBoundary

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 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 (http://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: 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"

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"

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".

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" 

Related topics

Community Additions

ADD
Show: