Edit

Share via

Remove-CMBoundaryFromGroup

  • Reference
Module:
ConfigurationManager

Removes a Configuration Manager boundary from a boundary group.

Syntax

Remove-CMBoundaryFromGroup
      -BoundaryGroupId <Int32>
      -BoundaryId <Int32>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMBoundaryFromGroup
      -BoundaryGroupId <Int32>
      -BoundaryName <String>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMBoundaryFromGroup
      -BoundaryGroupId <Int32>
      -BoundaryInputObject <IResultObject>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMBoundaryFromGroup
      -BoundaryGroupInputObject <IResultObject>
      -BoundaryId <Int32>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMBoundaryFromGroup
      -BoundaryGroupInputObject <IResultObject>
      -BoundaryName <String>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMBoundaryFromGroup
      -BoundaryGroupInputObject <IResultObject>
      -BoundaryInputObject <IResultObject>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMBoundaryFromGroup
      -BoundaryGroupName <String>
      -BoundaryId <Int32>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMBoundaryFromGroup
      -BoundaryGroupName <String>
      -BoundaryName <String>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMBoundaryFromGroup
      -BoundaryGroupName <String>
      -BoundaryInputObject <IResultObject>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Remove-CMBoundaryFromGroup cmdlet removes a Configuration Manager boundary from a boundary group. A boundary is a network address range, subnet, or Active Directory site that identifies a group of computers that are close in the network. A boundary group is a collection of boundaries.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Remove a boundary from a group by using the boundary name

PS XYZ:\> Remove-CMBoundaryFromGroup -BoundaryGroupID "16777219" -BoundaryName "CLBound03"

This example removes a boundary named CLBound03 from a boundary group that has the ID 16777219.

Example 2: Remove multiple boundary groups by using an InputObject

PS XYZ:\> $BoundaryObj = Get-CMBoundary -Name "Bound01", "Bound02", "Bound03"
PS XYZ:\> Remove-CMBoundaryFromGroup -Boundary $BoundaryObj -BoundaryGroupName "BGroup02"

The first command uses the Get-CMBoundary cmdlet to get multiple boundaries that are specified by their names, and stores this data into the $BoundaryObj variable.

The second command identifies and removes the boundaries that are specified by using the input object $BoundaryObj. Because the Force parameter is not specified, you must confirm the action before it is performed.

Parameters

-BoundaryGroupId

Specifies an ID for the boundary group from which you remove a boundary.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BoundaryGroupInputObject

Type:IResultObject
Aliases:BoundaryGroup
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BoundaryGroupName

Specifies a name for the boundary group from which you remove a boundary.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BoundaryId

Specifies an ID for the boundary that this cmdlet removes.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BoundaryInputObject

Type:IResultObject
Aliases:Boundary
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BoundaryName

Specifies a name for the boundary that this cmdlet removes.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-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

-Force

Forces the command to run without asking for user confirmation.

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

-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