Set-CMActiveDirectoryForest
Set-CMActiveDirectoryForest
Changes Active Directory forest properties in Configuration Manager.
構文
Parameter Set: SetById
Set-CMActiveDirectoryForest -Id <String[]> [-Description <String> ] [-EnableDiscovery <Boolean> ] [-PublishingPath <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByFQDN
Set-CMActiveDirectoryForest -ForestFqdn <String> [-Description <String> ] [-EnableDiscovery <Boolean> ] [-PublishingPath <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByValue
Set-CMActiveDirectoryForest -InputObject <IResultObject> [-Description <String> ] [-EnableDiscovery <Boolean> ] [-PublishingPath <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The Set-CMActiveDirectoryForest cmdlet changes values for an Active Directory forest object in Microsoft System Center 2012 Configuration Manager. You can edit the description, enable or disable discovery, and specify a fully qualified domain name (FQDN) and publishing path. You can specify an Active Directory forest object by ID or FQDN, or you can supply the Active Directory forest object itself.
Active Directory Forest Discovery requires a global account to discover or publish to untrusted forests.
パラメーター
-Description<String>
Specifies a description for an Active Directory forest object.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EnableDiscovery<Boolean>
Specifies whether to discover Active Directory sites and subnets. You must configure an Active Directory Forest Discovery method before you use this parameter. Valid values are: $True or $False. The default value is $False.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ForestFqdn<String>
Specifies the FQDN of a Configuration Manager object.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Id<String[]>
Specifies an array of IDs of Configuration Manager objects. You can find the identifier value in the ForestID property of an Active Directory forest.
エイリアス |
ForestId |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-InputObject<IResultObject>
Specifies an Active Directory forest object in Configuration Manager.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-PublishingPath<String>
Specifies one or more Configuration Manager sites that publish site information to an Active Directory forest. You can use a comma-separated list in quotation marks to specify more than one site.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Confirm
コマンドレットを実行する前に、ユーザーに確認を求めます。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WhatIf
コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
例
Example 1: Change the description of an Active Directory forest
This command changes the description of an Active Directory forest that has the ID 16777217 to AD Forest 01.
PS C:\> Set-CMActiveDirectoryForest -Id "16777217" -Description "AD Forest 01"