Compartir a través de

New-AzureRmPublicIpAddress

  • Referencia
Módulo:
AzureRM.Network

Crea una dirección IP pública.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto 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 recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda 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