Share via


Get-CMActiveDirectoryForest

Obtém um ou mais objetos florestais do Active Directory.

Syntax

Get-CMActiveDirectoryForest
   [-ForestFqdn <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMActiveDirectoryForest
   -Id <String[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

O cmdlet Get-CMActiveDirectoryForest obtém um ou mais objetos florestais do Active Directory no Configuration Manager. Você pode obter um objeto floresta do Active Directory por ID ou nome de domínio totalmente qualificado (FQDN).

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: obter todos os objetos florestais do Active Directory

PS XYZ:\> Get-CMActiveDirectoryForest

Esse comando obtém todos os objetos florestais do Active Directory.

Exemplo 2: Obter um objeto Active Directory Forest por ID

PS XYZ:\> Get-CMActiveDirectoryForest -Id "16777217"

Esse comando obtém um objeto floresta do Active Directory que tem a ID 16777217.

Exemplo 3: Obter a Floresta do Active Directory por nome de domínio

PS XYZ:\> Get-CMActiveDirectoryForest -ForestFqdn "tsqa.contoso.com"

Esse comando obtém um objeto floresta do Active Directory que tem o tsqa.contoso.com do FQDN.

Parâmetros

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-ForestFqdn

Especifica o FQDN de um objeto Configuration Manager.

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

-Id

Especifica uma matriz de IDs de objetos Configuration Manager. Você pode encontrar o valor do identificador na propriedade ForestID de uma floresta do Active Directory.

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

Entradas

None

Saídas

IResultObject[]

IResultObject