New-AzPublicIpAddress
Crea una dirección IP pública.
Syntax
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 $locationEste 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 $customFqdnEste 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 $ipTagEste 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 StandardEste 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 StandardEste 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 GlobalEste 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 $locationEste 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.
| Type: | String |
| Accepted values: | Dynamic, Static |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AsJob
Ejecución del cmdlet en segundo plano
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DdosProtectionMode
DdosProtectionMode que se va a usar para la dirección IP pública
| Type: | String |
| Accepted values: | VirtualNetworkInherited, Enabled, Disabled |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DdosProtectionPlanId
Identificador DdosProtectionPlan que se va a adjuntar a la dirección IP pública
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainNameLabel
Especifica el nombre DNS relativo para una dirección IP pública.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DomainNameLabelScope
Especifica hashedReusePolicy para el nombre DNS de una dirección IP pública.
| Type: | Nullable<T>[PSDomainNameLabelScopeType] |
| Accepted values: | TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EdgeZone
Nombre de la ubicación extendida.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdleTimeoutInMinutes
Especifica el tiempo de espera de inactividad, en minutos.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IpAddress
Especifica la dirección IP al crear un byOIP publicIpAddress.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IpAddressVersion
Especifica la versión de la dirección IP.
| Type: | String |
| Accepted values: | IPv4, IPv6 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IpTag
Lista de IpTag.
| Type: | PSPublicIpTag[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Location
Especifica la región en la que se va a crear una dirección IP pública.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica el nombre de la dirección IP pública que crea este cmdlet.
| Type: | String |
| Aliases: | ResourceName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PublicIpPrefix
Especifica el PSPublicIpPrefix desde el que se va a asignar la dirección IP pública.
| Type: | PSPublicIpPrefix |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
Especifica el nombre del grupo de recursos en el que se va a crear una dirección IP pública.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReverseFqdn
Especifica un nombre de dominio completo (FQDN) inverso.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Sku
Nombre de SKU de ip pública.
| Type: | String |
| Accepted values: | Basic, Standard |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tag
Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tier
Nivel de SKU de IP pública.
| Type: | String |
| Accepted values: | Regional, Global |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Zone
Una lista de zonas de disponibilidad de las que se indica la dirección IP asignada para el recurso debe proceder.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Entradas
String[]
Salidas
Vínculos relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de