Get-CMActiveDirectorySite

SYNOPSIS

Gets Configuration Manager sites that publish data to AD DS.

SYNTAX

SearchByName (Default)

Get-CMActiveDirectorySite [-Name <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

SearchByIdMandatory

Get-CMActiveDirectorySite -Id <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

SearchByForestName

Get-CMActiveDirectorySite -ForestFqdn <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

SearchByForestId

Get-CMActiveDirectorySite -ForestId <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

DESCRIPTION

The Get-CMActiveDirectorySite cmdlet gets one or more Microsoft System Center Configuration Manager sites that are configured to publish site information to Active Directory® Domain Services (AD DS). You can get System Center Configuration Manager sites that publish site data to AD DS by using an identifier or a fully qualified domain name (FQDN).

EXAMPLES

Example 1: Get an Active Directory site

PS C:\> Get-CMActiveDirectorySite

This command gets the Active Directory sites that are configured to publish site information.

PARAMETERS

-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

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

-ForestFqdn

Specifies an array of fully qualified domain names that identify Active Directory forests. The FQDN provides a path to an Active Directory forest.

Type: String[]
Parameter Sets: SearchByForestName
Aliases: 

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

-ForestId

Specifies an array of IDs that identify Active Directory forests.

Type: String[]
Parameter Sets: SearchByForestId
Aliases: 

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

-Id

Specifies an array of identifiers of Active Directory forest objects that contain Active Directory sites.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: SiteId

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

-Name

Specifies an array of FQDNs of Active Directory forest objects that contain Active Directory sites.

Type: String
Parameter Sets: SearchByName
Aliases: ADSiteName

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

NOTES

Get-CMActiveDirectoryForest