New-AzPublicIpAddress

  • Referencia
Módulo:
Az.Network

Crea una dirección IP pública.

Sintaxis

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 -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).

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 -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-AzPublicIpTag y pasarse 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.

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

-DdosProtectionMode

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

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

-DdosProtectionPlanId

Identificador DdosProtectionPlan que se va a adjuntar a la 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

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, 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

-DomainNameLabelScope

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

Tipo:Nullable<T>[PSDomainNameLabelScopeType]
Valores aceptados:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EdgeZone

Nombre de la ubicación extendida.

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

-IpAddress

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

Tipo:String
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: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:True
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

-Tier

Nivel de SKU de IP pública.

Tipo:String
Valores aceptados:Regional, Global
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:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Salidas

PSPublicIpAddress