Get-CMActiveDirectoryForest

获取一个或多个 Active Directory 林对象。

语法

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

说明

Get-CMActiveDirectoryForest cmdlet 获取 Configuration Manager 中的一个或多个 Active Directory 林对象。 可以按 ID 或完全限定的域名 (FQDN) 获取 Active Directory 林对象。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:获取所有 Active Directory 林对象

PS XYZ:\> Get-CMActiveDirectoryForest

此命令获取所有 Active Directory 林对象。

示例 2:按 ID 获取 Active Directory 林对象

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

此命令获取具有16777217 ID 的 Active Directory 林对象。

示例 3:按域名获取 Active Directory 林

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

此命令获取具有 FQDN tsqa.contoso.com 的 Active Directory 林对象。

参数

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForestFqdn

指定 Configuration Manager 对象的 FQDN。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-Id

指定 Configuration Manager 对象的 ID 数组。 可以在 Active Directory 林的 ForestID 属性中找到标识符值。

类型:String[]
别名:ForestId
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

输入

None

输出

IResultObject[]

IResultObject