Add-DhcpServerInDC

Add-DhcpServerInDC

Adds the computer running the DHCP server service to the list of authorized Dynamic Host Configuration Protocol (DHCP) server services in Active Directory (AD).

構文

Parameter Set: Add0
Add-DhcpServerInDC [[-DnsName] <String> ] [[-IPAddress] <IPAddress> ] [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




詳細説明

The Add-DhcpServerInDC cmdlet adds the computer running the DHCP server service to the list of authorized Dynamic Host Configuration Protocol (DHCP) server services in the Active Directory (AD). A DHCP server service running on a domain joined computer needs to be authorized in AD so that it can start leasing IP addresses on the network.

If neither the DnsName nor the IPAddress parameter is specified, the local server will be added in the AD.

If only the DnsName parameter is specified, the specified Domain Name System (DNS) name will be added in AD.

In both these cases, any of the IP addresses of the computer running the DHCP server service being added into the domain controller are added as part of the server object in AD.

If the DnsName and the IPAddress parameter are specified, the object will be added to domain controller with specified values.

In addition to adding the computer running the DHCP server service in DC, this cmdlet also triggers the DHCP server service to perform an authorization check.

The trigger for authorization check will be done even if the addition of computer running the DHCP server service fails with an object already exists error.

The following warning will be displayed if the computer running the DHCP server service is already authorized and the trigger for the server authorization check succeeded:
- The DHCP server is already authorized in Active Directory. The authorization check on the DHCP server has been initiated.

The following warning will be displayed if the computer running the DHCP server service is already authorized, but the trigger for the server authorization check failed:
- The DHCP server is already authorized in Active Directory. Failed to initiate the authorization check on the DHCP server. Error code: %d

The following warning will be displayed if the addition of the computer running the DHCP server service in AD succeeded, but the trigger for the server authorization check failed:
- The DHCP server has been successfully authorized in Active Directory. Failed to initiate the authorization check on the DHCP server. Error code: %d

If the addition of computer running the DHCP server service to AD fails with an error other than object_already_exists_error, then an error is returned and authorization check on the server is not triggered.

パラメーター

-AsJob

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。


エイリアス

Session

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-DnsName<String>

Specifies the DNS name of the computer running the DHCP server service to be added to the list of authorized DHCP server services in AD.


エイリアス

なし

必須?

false

位置は?

2

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-IPAddress<IPAddress>

Specifies the IP address of the computer running the DHCP server service which is added to the list of authorized DHCP server services in AD.


エイリアス

なし

必須?

false

位置は?

3

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットによる出力はありません。


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-ThrottleLimit<Int32>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。


必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。


必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

EXAMPLE 1

This example adds an object in the AD domain for the DHCP server service running on the computer with the DNS name dhcpserver.contoso.com and the IP address 10.10.10.2, and authorizes the DHCP server service to serve DHCP clients on the network.


PS C:\> Add-DhcpServerInDC -DnsName dhcpserver.contoso.com -IPAddress 10.10.10.2

EXAMPLE 2

This example adds an object in the AD domain for the DHCP server service running on the computer with the DNS name dhcpserver.contoso.com, and authorizes the DHCP server service to serve DHCP clients on the network. The IP address for the DHCP server service object in AD will be obtained by looking up dhcpserver.contoso.com in DNS.


PS C:\> Add-DhcpServerInDC -DnsName dhcpserver.contoso.com

EXAMPLE 3

This example adds an object in the AD domain for the DHCP server service running on the local computer. The IP address for the computer running the DHCP server service in AD will be obtained by looking up the hostname of the local computer in DNS.


PS C:\> Add-DhcpServerInDC

関連トピック

コミュニティの追加

追加
表示: