New-NetIPAddress

New-NetIPAddress

Creates and configures an IP address.

Sintaxis

Parameter Set: ByInterfaceAlias
New-NetIPAddress [-IPAddress] <String> -InterfaceAlias <String> [-AddressFamily <AddressFamily> {IPv4 | IPv6} ] [-CimSession <CimSession[]> ] [-DefaultGateway <String> ] [-PolicyStore <String> ] [-PreferredLifetime <TimeSpan> ] [-PrefixLength <Byte> ] [-SkipAsSource <Boolean> ] [-ThrottleLimit <Int32> ] [-Type <Type> {Unicast | Anycast} ] [-ValidLifetime <TimeSpan> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: ByInterfaceIndex
New-NetIPAddress [-IPAddress] <String> -InterfaceIndex <UInt32> [-AddressFamily <AddressFamily> {IPv4 | IPv6} ] [-CimSession <CimSession[]> ] [-DefaultGateway <String> ] [-PolicyStore <String> ] [-PreferredLifetime <TimeSpan> ] [-PrefixLength <Byte> ] [-SkipAsSource <Boolean> ] [-ThrottleLimit <Int32> ] [-Type <Type> {Unicast | Anycast} ] [-ValidLifetime <TimeSpan> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Descripción detallada

The New-NetIPAddress cmdlet creates and configures an IP address. To create a specific IP address object, specify either an IPv4 address or an IPv6 address, and an interface index or interface alias. We recommend that you define the prefix length, also known as a subnet mask, and a default gateway.

If you run this cmdlet to add an IP address to an interface on which DHCP is already enabled, then DHCP is automatically disabled.

Parámetros

-AddressFamily<AddressFamily>

Specifies an IP address family. The cmdlet creates an IP address for the family. If you do not specify this parameter, the property is automatically generated. Los valores aceptables para este parámetro son:

-- IPv4
-- IPv6

Alias

none

¿Necesario?

false

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-CimSession<CimSession[]>

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.

Alias

Session

¿Necesario?

false

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-DefaultGateway<String>

Specifies the IPv4 address or IPv6 address of the default gateway for the host. Default gateways provide a default route for TCP/IP hosts to use when communicating with other hosts on remote networks.

Alias

none

¿Necesario?

false

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-InterfaceAlias<String>

Specifies an alias of a network interface. The cmdlet creates an IP address for the alias.

Alias

ifAlias

¿Necesario?

true

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-InterfaceIndex<UInt32>

Specifies an index of a network interface. The cmdlet creates an IP address for the index.

Alias

ifIndex

¿Necesario?

true

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-IPAddress<String>

Specifies the IPv4 or IPv6 address to create.

Alias

LocalAddress

¿Necesario?

true

¿Posición?

1

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-PolicyStore<String>

Specifies a PolicyStore value. Los valores aceptables para este parámetro son:

-- ActiveStore. The IP address information is valid.
-- PersistentStore. The computer saves IP address information across restarts. When the computer restarts, it copies the saved settings to the ActiveStore.

The default value is ActiveStore. Specify ActiveStore only.

If you do not specify this parameter, the default entries are created in both the ActiveStore and the PersistentStore.

Alias

none

¿Necesario?

false

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-PreferredLifetime<TimeSpan>

Specifies a preferred lifetime, as a TimeSpan object, for an IP address. To obtain a TimeSpan object, use the New-TimeSpan cmdlet.

Alias

none

¿Necesario?

false

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-PrefixLength<Byte>

Specifies a prefix length. This parameter defines the local subnet size, and is also known as a subnet mask.

Alias

none

¿Necesario?

false

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-SkipAsSource<Boolean>

Indicates whether an address is a primary IP address. This parameter identifies the primary IP address for outgoing traffic in a multiple IP address scenario. If this parameter is set to True, the addresses are not used for outgoing traffic and are not registered in DNS.

Alias

none

¿Necesario?

false

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-ThrottleLimit<Int32>

Especifica el número máximo de operaciones simultáneas que pueden establecerse para ejecutar el cmdlet. Si se omite este parámetro o si se escribe un valor de 0, Windows PowerShell® calcula un límite óptimo para el cmdlet en función del número de cmdlets CIM que se ejecutan en el equipo. El límite solo se aplica al cmdlet actual, no a la sesión o al equipo.

Alias

none

¿Necesario?

false

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-Type<Type>

Specifies an IP address type. Los valores aceptables para este parámetro son:

-- Unicast
-- Anycast

The default value is Unicast.

Alias

none

¿Necesario?

false

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-ValidLifetime<TimeSpan>

Specifies a valid lifetime value, as a TimeSpan object, for an IP address. To obtain a TimeSpan object, use the New-TimeSpan cmdlet.

Alias

none

¿Necesario?

false

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

¿Necesario?

false

¿Posición?

named

Valor predeterminado

false

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Muestra lo que sucedería si se ejecuta el cmdlet. El cmdlet no se ejecuta.

¿Necesario?

false

¿Posición?

named

Valor predeterminado

false

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

<WorkflowParameters>

Entradas

El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet.

  • None

Salidas

El tipo de resultado es el tipo de los objetos que el cmdlet emite.

  • Microsoft.Management.Infrastructure.CimInstance#root\StandardCimv2\MSFT_NetIPAddress

    El objeto Microsoft.Management.Infrastructure.CimInstance es una clase contenedora que muestra los objetos de Instrumental de administración de Windows (WMI). La ruta de acceso después de la almohadilla (#) proporciona el espacio de nombres y el nombre de clase del objeto WMI subyacente.

Ejemplos

Example 1: Add an IPv4 address

The first command adds a new IPv4 address to the network interface at index 12. The PrefixLength parameter specifies the subnet mask for the IP address. In this example, the PrefixLength of 24 equals a subnet mask of 255.255.255.0. When you add an IPv4 address, the address specified for the Default Gateway must be in the same subnet as the IPv4 address that you add.

PS C:\> New-NetIPAddress –InterfaceIndex 12 –IPAddress 192.168.0.1 -PrefixLength 24 -DefaultGateway 192.168.0.5

The second command removes the IPv4 address. To remove the IPv4 address, use the Remove-NetIPAddress cmdlet.

PS C:\> Remove-NetIPAddress –IPAddress 192.168.0.1 -DefaultGateway 192.168.0.5

Temas relacionados

Get-NetIPAddress

Remove-NetIPAddress

Remove-NetRoute

Set-NetIPAddress