Remove-DhcpServerInDC

Remove-DhcpServerInDC

Deletes the specified Dynamic Host Configuration Protocol (DHCP) server service from the list of authorized DHCP server services in Active Directory (AD).

構文

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




詳細説明

The Remove-DhcpServerInDC cmdlet deletes the specified Dynamic Host Configuration Protocol (DHCP) server service from the list of authorized DHCP server services in Active Directory (AD).

When neither the DnsName nor the IPAddress parameter is specified, then the local DHCP server service will be removed from the list of authorized DHCP server services in AD.

If only the DnsName parameter is specified, then the DHCP server service running on the computer with the specified DNS name will be removed from the list of authorized DHCP server services in AD.

If the DnsName and the IPAddress parameters are specified, then the DHCP server service running on the computer with specified values will be removed from the list of authorized DHCP server services in AD.

If only the IPAddress parameter is specified, then an error is returned.

In addition to removing 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 removal 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 does not exist in AD and the trigger for the server authorization check succeeded:
- The DHCP server is already de-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 does not exist in AD, but the trigger for the server authorization check failed:
- The DHCP server is already de-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 deletion 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 de-authorized in Active Directory. Failed to initiate the authorization check on the DHCP server. Error code: %d

If the deletion of computer running the DHCP server service to AD fails with an error other than object_does not 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, on which the DHCP server service is running, to de-authorize.


エイリアス

なし

必須?

false

位置は?

2

既定値

なし

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

True (ByPropertyName)

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

false

-IPAddress<IPAddress>

Specifies the IP address of the computer, on which the DHCP server service is running, to de-authorize.


エイリアス

なし

必須?

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 deletes the 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, thereby de-authorizing the DHCP server service for clients on the network.


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

EXAMPLE 2

This example deletes an object in the AD domain for the DHCP server service running on the computer with the DNS name dhcpserver.contoso.com, thereby de-authorizing the DHCP server service for the clients on the network. The IP address for computer running the DHCP server service object in AD will be obtained by looking up dhcpserver.contoso.com in DNS.


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

EXAMPLE 3

This example deletes an object in the AD domain for the DHCP server service running on the local computer.


PS C:\> Remove-DhcpServerInDC

関連トピック

コミュニティの追加

追加
表示: