New-CMActiveDirectoryForest
在 Configuration Manager 中创建一个或多个 Active Directory 林对象。
语法
New-CMActiveDirectoryForest
[-Description <String>]
[-EnableDiscovery <Boolean>]
-ForestFqdn <String>
[-Password <SecureString>]
[-PublishingPath <String>]
[-UserName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
New-CMActiveDirectoryForest cmdlet 创建一个 Active Directory 林对象，该对象具有完全限定的域名， (你提供的 FQDN) 、说明和发布路径。
如果配置了 Active Directory 林发现方法，则可以为 Active Directory 林启用发现。 启用发现后，Configuration Manager 会发现 Active Directory 站点和子网。
Active Directory 林发现需要全局帐户才能发现或发布到不受信任的林。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：创建启用了发现的 Active Directory 林对象
PS XYZ:\> New-CMActiveDirectoryForest -ForestFqdn "tsqa.contoso.com" -EnableDiscovery $True此命令创建具有 FQDN tsqa.contoso.com 且已启用发现的 Active Directory 林对象。 必须先配置 Active Directory 林发现方法，然后发现才能正常工作。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
指定 Active Directory 林对象的说明。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableDiscovery
指定是否发现 Active Directory 站点和子网。 如果启用发现，则必须配置 Active Directory 林发现方法。 默认值为 $False。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForestFqdn
指定 Configuration Manager 对象的 FQDN。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Password
{{ 填写密码说明 }}
| 类型: | SecureString |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PublishingPath
指定将站点信息发布到 Active Directory 林的一个或多个 Configuration Manager 站点。 可以使用引号中的逗号分隔列表来指定多个站点。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UserName
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
输出
IResultObject