Get-CMBoundaryGroupSiteSystem

Get site systems in the specified boundary group

Syntax

Get-CMBoundaryGroupSiteSystem
   [-GroupName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMBoundaryGroupSiteSystem
   -Id <String[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMBoundaryGroupSiteSystem
   [-InputObject <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use this cmdlet to get site systems in the specified boundary group. For more information, see About boundary groups in Configuration Manager.

Note

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

Examples

Example 1: Display FQDNs of site systems in a boundary group

This example first gets a boundary group by name and saves that object in a variable $boundaryGroup. It then queries for the site systems in that boundary group by passing the boundary group object, and saves the results in a variable $bgSiteSystems.

The foreach loop then goes through each site system object and extracts the FQDN from the NAL path.

$bgName = "Contoso HQ BG"
$boundaryGroup = Get-CMBoundaryGroup -Name $bgName

$bgSiteSystems = Get-CMBoundaryGroupSiteSystem -InputObject $boundaryGroup

foreach ($system in $bgSiteSystems) {
  Write-Host $system.ServerNalPath.TrimEnd('\').Split('\')[-1]
}

Parameters

-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

-GroupName

Specify a boundary group name to get the associated site systems.

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

-Id

Specify an array of boundary group IDs to get the associated site systems. This value is an integer, for example 5.

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

-InputObject

Specify a boundary group object to get the associated site systems. To get this object, use the Get-CMBoundaryGroup cmdlet.

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

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

IResultObject[]

IResultObject

Notes

For more information on this return object and its properties, see SMS_BoundaryGroupSiteSystems server WMI class.