Add-DhcpServerv6Reservation

Artigo
11/17/2015

Add-DhcpServerv6Reservation

Adds an IPv6 Reservation to an IPv6 prefix or scope.

Sintaxe

Parameter Set: Add0
Add-DhcpServerv6Reservation [-Prefix] <IPAddress> [-IPAddress] <IPAddress> [-ClientDuid] <String> [-Iaid] <UInt32> [[-Name] <String> ] [-AsJob] [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-Description <String> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descrição detalhada

The Add-DhcpServerv6Reservation cmdlet reserves a specified IPv6 address for the client identified by the specified Dynamic Host Configuration Protocol (DHCP) v6 unique identifier (ID) (DUID) and identity association ID (IAID).

Parâmetros

-AsJob

Aliases	nenhuma
Necessário?	false
Posição?	named
Valor padrão	nenhuma
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-CimSession<CimSession[]>

Executa o cmdlet em uma sessão remota ou em um computador remoto. Insira um nome do computador ou um objeto de sessão, como a saída de um cmdlet New-CimSession ou Get-CimSession. O padrão é a sessão atual do computador local.

Aliases	Session
Necessário?	false
Posição?	named
Valor padrão	nenhuma
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-ClientDuid<String>

Specifies the DUID of the client.

Aliases	Duid
Necessário?	true
Posição?	4
Valor padrão	nenhuma
Aceitar entrada do pipeline?	True (ByPropertyName)
Aceitar caracteres curinga?	false

-ComputerName<String>

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

Aliases	Cn,ReservationServer
Necessário?	false
Posição?	named
Valor padrão	nenhuma
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Description<String>

Specifies the description string for the IPv6 reservation being created.

Aliases	ReservationDescription
Necessário?	false
Posição?	named
Valor padrão	nenhuma
Aceitar entrada do pipeline?	True (ByPropertyName)
Aceitar caracteres curinga?	false

-Iaid<UInt32>

Specifies the DHCPv6 IAID of a specific network interface of the client.

Aliases	nenhuma
Necessário?	true
Posição?	5
Valor padrão	nenhuma
Aceitar entrada do pipeline?	True (ByPropertyName)
Aceitar caracteres curinga?	false

-IPAddress<IPAddress>

Specifies the IPv6 address to be reserved for the client.

Aliases	ReservedIP
Necessário?	true
Posição?	3
Valor padrão	nenhuma
Aceitar entrada do pipeline?	True (ByPropertyName)
Aceitar caracteres curinga?	false

-Name<String>

Specifies the name of the client. This parameter value can be the actual host name of the client or a name assigned to identify the reserved client on the DHCP server service.

Aliases	HostName,ReservationName
Necessário?	false
Posição?	6
Valor padrão	nenhuma
Aceitar entrada do pipeline?	True (ByPropertyName)
Aceitar caracteres curinga?	false

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, este cmdlet não gera saída.

Aliases	nenhuma
Necessário?	false
Posição?	named
Valor padrão	nenhuma
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Prefix<IPAddress>

Specifies the IPv6 prefix which identifies the scope in which the reservation is created.

Aliases	ReservationScopeID
Necessário?	true
Posição?	2
Valor padrão	nenhuma
Aceitar entrada do pipeline?	True (ByPropertyName)
Aceitar caracteres curinga?	false

-ThrottleLimit<Int32>

Especifica o número máximo de operações simultâneas que podem ser estabelecidas para executar o cmdlet. Se esse parâmetro for omitido ou um valor de 0 for inserido, o Windows PowerShell® calculará o limite ideal de restrição para o cmdlet com base no número de cmdlets do CIM que estão em execução no computador. O limite de restrição se aplica somente ao cmdlet atual, e não à sessão ou ao computador.

Aliases	nenhuma
Necessário?	false
Posição?	named
Valor padrão	nenhuma
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Confirm

Solicita que você confirme antes de executar o cmdlet.

Necessário?	false
Posição?	named
Valor padrão	false
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Necessário?	false
Posição?	named
Valor padrão	false
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet dá suporte a parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet.

Microsoft.Management.Infrastructure.CimInstance#root/Microsoft/Windows/DHCP/DhcpServerv6Reservation

O objeto Microsoft.Management.Infrastructure.CimInstance é uma classe wrapper que exibe objetos da WMI (Instrumentação de Gerenciamento do Windows). O caminho após o sinal de cerquilha (#) indica o namespace e o nome de classe do objeto subjacente da WMI.

Saídas

O tipo de saída é o tipo de objeto emitido pelo cmdlet.

Microsoft.Management.Infrastructure.CimInstance#root/Microsoft/Windows/DHCP/DhcpServerv6Reservation

O objeto Microsoft.Management.Infrastructure.CimInstance é uma classe wrapper que exibe objetos da WMI (Instrumentação de Gerenciamento do Windows). O caminho após o sinal de cerquilha (#) indica o namespace e o nome de classe do objeto subjacente da WMI.

Exemplos

EXAMPLE 1

This example reserves the specified IPv6 address for the specified ClientDuid and Iaid parameter values. After the reservation is added, the DHCP server service will assign only the specified IP address to the client request which contains the specified ClientDuid and Iaid parameter values.

PS C:\> Add-DhcpServerv6Reservation -Prefix 2001:4898:7020:1020:: -IPAddress 2001:4898:7020:1020::1 -ClientDuid 00-01-00-01-15-F9-7F-AB-F0-DE-F1-7A-00-5E -Iaid 234890455

EXAMPLE 2

This example adds all of the reservations in the file named Reservations.csv to the DHCP server service running on the computer named dhcpserver.contoso.com. The Import-Csv cmdlet returns the objects with reservation fields and pipes the objects to this cmdlet, which adds these reservations to the DHCP server service. The file named Reservations.csv should contain the reservations in the following comma-separated values (CSV) format:

Prefix,IPAddress,Name,ClientDuid,Iaid,Description
2001:4898:7020:1020::,2001:4898:7020:1020::1,Computer1,00-01-00-01-15-F9-7F-AB-F0-DE-F1-7A-00-5E,234890455,Reserved for Computer1
2001:4898:7020:1020::,2001:4898:7020:1020::2,Computer2,00-01-00-01-15-F9-7F-AB-F0-DE-F1-7A-00-6E,234890465,Reserved for Computer2
2001:4898:7020:1020::,2001:4898:7020:1020::3,Computer3,00-01-00-01-15-F9-7F-AB-F0-DE-F1-7A-00-7E,234890475,Reserved for Computer3

PS C:\> Import-Csv –Path Reservations.csv | Add-DhcpServerv6Reservation -ComputerName dhcpserver.contoso.com

Example 3

This example creates a reservation for the client identified by the specified client ID from any of the free IP address in the scope 2001:4898:7020:1020::. The Get-DhcpServerv6FreeIPAddress cmdlet fetches a free IP address in that scope, then this cmdlet reserves the IP address for the specified client ID.

PS C:\> $freeip = Get-DhcpServerv6FreeIPAddress -ComputerName dhcpserver.contoso.com -Prefix 2001:4898:7020:1020::
PS C:\> Add-DhcpServerv6Reservation -ComputerName dhcpserver.contoso.com -Prefix 2001:4898:7020:1020:: -IPAddress $freeip -ClientDuid 00-01-00-01-15-F9-7F-AB-F0-DE-F1-7A-00-5E -Iaid 234890455 -Description "Reservation for Printer"

EXAMPLE 4

This example converts one of the leases into a reservation. The Get-DhcpServerv6Lease cmdlet returns an IP address lease object and pipes the object to this cmdlet, which creates the reservation with the IP address, client DUID, and IAID in the lease object.

PS C:\> Get-DhcpServerv6Lease -ComputerName dhcpserver.contoso.com -IPAddress 2001:4898:7020:1020::11 | Add-DhcpServerv6Reservation -ComputerName dhcpserver.contoso.com -Prefix 2001:4898:7020:1020::