New-CMBoundary
Create a site boundary.
Syntax
New-CMBoundary
[-Name <String>]
-Type <BoundaryTypes>
-Value <String>
[-ValueStartsWith <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Use this cmdlet to create a site boundary. A boundary is a network location that contains one or more devices that you can manage. A boundary can be an IP subnet, Active Directory site name, IPv6 prefix, an IP address range, or a VPN. For more information, see Define site boundaries and boundary groups.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.
Examples
Example 1: Create an 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.
New-CMBoundary -DisplayName "IPSubNetBoundary01" -BoundaryType IPSubNet -Value "172.16.50.0/24"Example 2: Create an 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.
New-CMBoundary -DisplayName "ADSiteBoundary01" -BoundaryType ADSite -Value "Default-First-Site-Name"Example 3: Create an IPv6 prefix site boundary
This command creates a new IPv6 prefix site boundary that has a name of IPv6PrefixBoundary01 and a value of FE80::/64.
New-CMBoundary -DisplayName "IPv6PrefixBoundary01" -BoundaryType IPv6Prefix -Value "FE80::/64"Example 4: Create an 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.
New-CMBoundary -DisplayName "IPRangeBoundary01" -BoundaryType IPRange -Value "10.255.255.0-10.255.255.255"Example 5: Create a VPN site boundary
This command creates a new VPN site boundary that has the name VPN-CONTOSO1-Name and a value of Name:CONTOSO1.
New-CMBoundary -DisplayName "VPN-CONTOSO1-Name" -BoundaryType VPN -Value "Name:CONTOSO1"Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specify the name of the new boundary.
| Type: | String |
| Aliases: | DisplayName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Type
Specify the boundary type.
| Type: | BoundaryTypes |
| Aliases: | BoundaryType |
| Accepted values: | IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Value
Specify the data that defines the boundary. For example, an Active Directory site value can be Default-First-Site-Name.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ValueStartsWith
Set this parameter to $true to match the start of a connection name or description instead of the whole string. For more information, see Define network locations as boundaries.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet doesn't run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
None
Outputs
IResultObject
Notes
For more information on this return object and its properties, see SMS_Boundary server WMI class.