Add-DhcpServerv4Lease

Add-DhcpServerv4Lease

Adds a new IPv4 address lease in the Dynamic Host Configuration Protocol (DHCP) server service.

構文

Parameter Set: Add0
Add-DhcpServerv4Lease [-ScopeId] <IPAddress> [-IPAddress] <IPAddress> [-ClientId] <String> [-AddressState <String> ] [-AsJob] [-CimSession <CimSession[]> ] [-ClientType <String> ] [-ComputerName <String> ] [-Description <String> ] [-DnsRegistration <String> ] [-DnsRR <String> ] [-HostName <String> ] [-LeaseExpiryTime <DateTime> ] [-NapCapable <Boolean> ] [-NapStatus <String> ] [-PassThru] [-PolicyName <String> ] [-ProbationEnds <DateTime> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




詳細説明

The Add-DhcpServerv4Lease cmdlet adds a new IPv4 address lease on the Dynamic Host Configuration Protocol (DHCP) server service. This cmdlet is only supported for DHCP server service running on Windows Server® 2012. This cmdlet is for testing purposes only.

パラメーター

-AddressState<String>

Specifies the state of the IPv4 Address lease. このパラメーターに対して使用できる値: Offered, Active, Declined, Expired, or Inactive. The default value is Active.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

True (ByPropertyName)

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

false

-AsJob

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

false

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

false

-CimSession<CimSession[]>

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


エイリアス

Session

必須?

false

位置は?

named

既定値

なし

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

false

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

false

-ClientId<String>

Specifies the client identifier (ID) to be set on the IPv4 address lease. Windows clients use the MAC address as the client ID.


エイリアス

なし

必須?

true

位置は?

4

既定値

なし

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

True (ByPropertyName)

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

false

-ClientType<String>

Specifies the type of the client. このパラメーターに対して使用できる値: Unspecified, DHCP, BootP, Both, Reservation, or None.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

True (ByPropertyName)

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

false

-ComputerName<String>

Specifies the DNS name, or IPv4 or IPv6 address, of the target computer running the DHCP server service.


エイリアス

Cn

必須?

false

位置は?

named

既定値

なし

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

false

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

false

-Description<String>

Specifies the description string to be set on the IPv4 address lease.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

True (ByPropertyName)

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

false

-DnsRegistration<String>

Indicates the status of the DNS registration of the lease.
このパラメーターに対して使用できる値:
- Complete: For an active lease, registration of the required records , as specified by the DnsRR parameter value of PTR or AandPTR, is complete.
     - - For an expired lease, deletion of the required records has been done.
- Pending: For an active lease, registration of the required records, as specified by the DnsRR parameter value of PTR or AandPTR, is pending.
     - - For an expired lease, deletion of the required records is pending.
- Not applicable: When the DnsRR parameter is set to NoRegistration such as when no dynamic DNS registration is to be performed by the DHCP server service, this parameter is set to Not applicable.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

True (ByPropertyName)

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

false

-DnsRR<String>

Indicates the type of DNS record to be registered by the DHCP server service for this lease. このパラメーターに対して使用できる値:
- PTR: Only PTR record to be registered by the DHCP server service.
- AandPTR: Both A and PTR records to be registered by the DHCP server service.
- NoRegistration: No DNS registration is done by the DHCP server service. If the dynamic DNS is turned off on the DHCP server service, then this parameter is set to NoRegistration.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

True (ByPropertyName)

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

false

-HostName<String>

Specifies the DNS host name of the client for which the IP address lease is to be added.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

True (ByPropertyName)

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

false

-IPAddress<IPAddress>

Specifies the IPv4 Address for which the IPv4 address lease record is to be added on the DHCP server service.


エイリアス

なし

必須?

true

位置は?

3

既定値

なし

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

True (ByPropertyName)

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

false

-LeaseExpiryTime<DateTime>

Specifies the expiry time of the IPv4 address lease.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

True (ByPropertyName)

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

false

-NapCapable<Boolean>

Indicates that the client is network access protection (NAP) capable. このパラメーターに対して使用できる値: True or False.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

True (ByPropertyName)

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

false

-NapStatus<String>

Specifies the NAP status of the client. このパラメーターに対して使用できる値: NoQuarantine, RestrictedAccess, DropPacket, Probation, Exempt, DefaultQuarSetting, or NoQuarInfo. The default value is NoQuarantine.

If this parameter is specified as Probation and a probation period is not specified, then this cmdlet will return an error.

If this parameter is not specified or is specified as something other than Probation and probation period is not specified, then the probation period to set to 0.

If this parameter is not specified and probation period is specified, then this parameter is set to Probation.

If this parameter is not specified or is specified as something other than Probation and the ProbationEnds parameter is specified, then this cmdlet will return an error.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

True (ByPropertyName)

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

false

-PassThru

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


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

false

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

false

-PolicyName<String>

Specifies the name of the policy to be set on the IPv4 address lease record being added.

Note: The DHCP server service does not check whether the policy specified exists on the server.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

True (ByPropertyName)

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

false

-ProbationEnds<DateTime>

Specifies the end-time of probation to be set on the IPv4 address lease record.
The default value is 0.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

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

True (ByPropertyName)

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

false

-ScopeId<IPAddress>

Specifies the subnet mask to be set on the IPv4 address lease record being added.


エイリアス

なし

必須?

true

位置は?

2

既定値

なし

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

True (ByPropertyName)

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

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 IPv4 address lease for the IPv4 address 10.10.10.11 on the DHCP server service running on the local computer.


PS C:\> Add-DhcpServerv4Lease -IPAddress 10.10.10.11 -ScopeId 10.10.10.0 -ClientId F0-DE-F1-7A-00-5E -LeaseExpiryTime "2012-01-28 01:38:13Z" -HostName MyComputer.contoso.com

関連トピック

コミュニティの追加

追加
表示: