Compartir a través de

New-AzPublicIpAddress

Módulo:
Az.Network Module

Crea una dirección IP pública.

Sintaxis

Default (valor predeterminado) 

New-AzPublicIpAddress
    [-Name <String>]
    -ResourceGroupName <String>
    -Location <String>
    [-EdgeZone <String>]
    [-Sku <String>]
    [-Tier <String>]
    -AllocationMethod <String>
    [-IpAddressVersion <String>]
    [-DomainNameLabel <String>]
    [-DomainNameLabelScope <PSDomainNameLabelScopeType>]
    [-IpTag <PSPublicIpTag[]>]
    [-PublicIpPrefix <PSPublicIpPrefix>]
    [-DdosProtectionMode <String>]
    [-DdosProtectionPlanId <String>]
    [-ReverseFqdn <String>]
    [-IdleTimeoutInMinutes <Int32>]
    [-Zone <String[]>]
    [-IpAddress <String>]
    [-Tag <Hashtable>]
    [-Force]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

Ejemplos

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

$publicIp = New-AzPublicIpAddress -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 el -AllocationMethod se especifica como "Estático". 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).

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

$publicIp = New-AzPublicIpAddress -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.

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

$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $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 el -AllocationMethod se especifica como "Estático". 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-AzPublicIpTag y pasar como entrada a través de -IpTags.

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

$publicIp = New-AzPublicIpAddress -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.

Ejemplo 5: Creación de una dirección IP pública específica a partir de un prefijo BYOIP

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -Location $location -IpAddress 0.0.0.0 -PublicIpPrefix $publicIpPrefix -Sku Standard

Este comando crea un nuevo recurso de dirección IP pública con una dirección IP específica. NRP comprobaría si la dirección IP especificada está dentro del PublicIpPrefix y si el valor de PublicIpPrefix especificado es BYOIP PublicIpPrefix. la dirección IP pública especificada se asigna inmediatamente a este recurso desde el valor publicIpPrefix especificado. Esta opción solo se admite para la SKU "Standard" y "Static" AllocationMethod y BYOIP PublicIpPrefix.

Ejemplo 6: Creación de una nueva dirección IP pública global

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $domainNameLabel -Location $location -Sku Standard -Tier Global

Este comando crea un nuevo recurso de dirección IP pública global. 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 global se asigna inmediatamente a este recurso. Esta opción solo se admite para la SKU "Estándar" y "Static" AllocationMethod.

Ejemplo 7: Creación de una dirección IP pública con domainNameLabelScope

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $location

Este comando crea un nuevo recurso de dirección IP pública. Con el parámetro -DomainNameLabelScope, Azure crea un registro DNS con un valor hash en FQDN para la dirección IP pública asignada a este recurso con la directiva sugerida por $hasedReusePolicy.

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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Dynamic, Static
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-AsJob

Ejecución del cmdlet en segundo plano

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DdosProtectionMode

DdosProtectionMode que se va a usar para la dirección IP pública

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:VirtualNetworkInherited, Enabled, Disabled
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DdosProtectionPlanId

Identificador DdosProtectionPlan que se va a adjuntar a la dirección IP pública

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DefaultProfile

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

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DomainNameLabel

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DomainNameLabelScope

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

Propiedades de parámetro

Tipo:

Nullable<T>[PSDomainNameLabelScopeType]

Valor predeterminado:None
Valores aceptados:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-EdgeZone

Nombre de la ubicación extendida.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IdleTimeoutInMinutes

Especifica el tiempo de espera de inactividad, en minutos.

Propiedades de parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IpAddress

Especifica la dirección IP al crear un byOIP publicIpAddress.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IpAddressVersion

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:IPv4, IPv6
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IpTag

Lista de IpTag.

Propiedades de parámetro

Tipo:

PSPublicIpTag[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Location

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Name

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:nombreDelRecurso

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-PublicIpPrefix

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

Propiedades de parámetro

Tipo:PSPublicIpPrefix
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ResourceGroupName

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ReverseFqdn

Especifica un nombre de dominio completo (FQDN) inverso.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Sku

Nombre de SKU de ip pública.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Basic, Standard, StandardV2
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Tag

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

Propiedades de parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Tier

Nivel de SKU de IP pública.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Regional, Global
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Zone

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

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

PSPublicIpTag

PSPublicIpPrefix

Int32

String

Hashtable

Salidas

PSPublicIpAddress