New-AzureRmPublicIpAddress

Módulo:

AzureRM.Network

Crea una dirección IP pública.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

New-AzureRmPublicIpAddress
   [-Name <String>]
   -ResourceGroupName <String>
   [-Location <String>]
   [-Sku <String>]
   -AllocationMethod <String>
   [-IpAddressVersion <String>]
   [-DomainNameLabel <String>]
   [-IpTag <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag]>]
   [-PublicIpPrefix <Microsoft.Azure.Commands.Network.Models.PSPublicIpPrefix>]
   [-ReverseFqdn <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-Zone <System.Collections.Generic.List`1[System.String]>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-AzureRmPublicIpAddress crea una dirección IP pública.

Ejemplos

1: Creación de una nueva dirección IP pública

$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location

Este comando crea un nuevo recurso de dirección IP pública. Se crea un registro DNS para $dnsPrefix.$location.cloudapp.azure.com que apunta a la dirección IP pública de este recurso. Una dirección IP pública se asigna inmediatamente a este recurso, ya que -AllocationMethod se especifica como "Static". Si se especifica como "Dinámico", solo se asigna una dirección IP pública al iniciar (o crear) el recurso asociado (como una máquina virtual o un equilibrador de carga).

2: Creación de una dirección IP pública con un FQDN inverso

$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -ReverseFqdn $customFqdn

Este comando crea un nuevo recurso de dirección IP pública. Con el parámetro -ReverseFqdn, Azure crea un registro PTR de DNS (búsqueda inversa) para la dirección IP pública asignada a este recurso, apuntando al $customFqdn especificado en el comando. Como requisito previo, el $customFqdn (por ejemplo, webapp.contoso.com) debe tener un registro CNAME dns (búsqueda directa) que apunte a $dnsPrefix.$location.cloudapp.azure.com.

3: Creación de una nueva dirección IP pública con IpTag

$ipTag = New-AzureRmPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTags ipTag

Este comando crea un nuevo recurso de dirección IP pública. Se crea un registro DNS para $dnsPrefix.$location.cloudapp.azure.com que apunta a la dirección IP pública de este recurso. Una dirección IP pública se asigna inmediatamente a este recurso, ya que -AllocationMethod se especifica como "Static". Si se especifica como "Dinámico", solo se asigna una dirección IP pública al iniciar (o crear) el recurso asociado (como una máquina virtual o un equilibrador de carga). Una iptag se usa para especificar las etiquetas asociadas al recurso. Iptag se puede especificar mediante New-AzureRmPublicIpTag y pasarse como entrada a través de -IpTags.

4: Crear una nueva dirección IP pública a partir de un prefijo

$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location
-PublicIpPrefix publicIpPrefix -Sku Standard

Este comando crea un nuevo recurso de dirección IP pública. Se crea un registro DNS para $dnsPrefix.$location.cloudapp.azure.com que apunta a la dirección IP pública de este recurso. Una dirección IP pública se asigna inmediatamente a este recurso desde el publicIpPrefix especificado. Esta opción solo se admite para la SKU "Estándar" y "Static" AllocationMethod.

Parámetros

-AllocationMethod

Especifica el método con el que se va a asignar la dirección IP pública. Los valores aceptables para este parámetro son: Estático o Dinámico.

Tipo:	String
Valores aceptados:	Dynamic, Static
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-AsJob

Ejecución del cmdlet en segundo plano

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DomainNameLabel

Especifica el nombre DNS relativo para una dirección IP pública.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-IdleTimeoutInMinutes

Especifica el tiempo de espera de inactividad, en minutos.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-IpAddressVersion

Especifica la versión de la dirección IP.

Tipo:	String
Valores aceptados:	IPv4, IPv6
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-IpTag

Lista de IpTag.

Tipo:	List<T>[PSPublicIpTag]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Location

Especifica la región en la que se va a crear una dirección IP pública.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Especifica el nombre de la dirección IP pública que crea este cmdlet.

Tipo:	String
Alias:	ResourceName
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-PublicIpPrefix

Especifica el PSPublicIpPrefix desde el que se va a asignar la dirección IP pública.

Tipo:	PSPublicIpPrefix
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ResourceGroupName

Especifica el nombre del grupo de recursos en el que se va a crear una dirección IP pública.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ReverseFqdn

Especifica un nombre de dominio completo (FQDN) inverso.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Sku

Nombre de SKU de ip pública.

Tipo:	String
Valores aceptados:	Basic, Standard
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Tag

Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}

Tipo:	Hashtable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Zone

Una lista de zonas de disponibilidad de las que se indica la dirección IP asignada para el recurso debe proceder.

Tipo:	List<T>[String]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

Entradas

String

List<T>[[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Int32

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Hashtable

Salidas

PSPublicIpAddress

Vínculos relacionados

• Get-AzureRmPublicIpAddress
• Remove-AzureRmPublicIpAddress
• Set-AzureRmPublicIpAddress