New-AzPublicIpPrefix
Crea un prefijo de dirección IP pública
Sintaxis
Default (valor predeterminado)
New-AzPublicIpPrefix
-Name <String>
-ResourceGroupName <String>
-Location <String>
[-Sku <String>]
[-Tier <String>]
-PrefixLength <UInt16>
[-IpAddressVersion <String>]
[-IpTag <PSPublicIpPrefixTag[]>]
[-Zone <String[]>]
[-CustomIpPrefix <PSCustomIpPrefix>]
[-EdgeZone <String>]
[-Tag <Hashtable>]
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-AcquirePolicyToken]
[-ChangeReference <String>]
[<CommonParameters>]
Description
El cmdlet New-AzPublicIpPrefix crea un prefijo de dirección IP pública.
Ejemplos
Ejemplo 1: Creación de un nuevo prefijo ip público
$publicIpPrefix = New-AzPublicIpPrefix -Name $prefixName -ResourceGroupName $rgName -PrefixLength 30
Este comando crea un nuevo recurso de prefijo de DIRECCIÓN IP pública.
Ejemplo 2: Creación de un nuevo prefijo de ip pública global
$publicIpPrefix = New-AzPublicIpPrefix -ResourceGroupName $rgname -name $rname -location $location -Tier Global -PrefixLength 30
Este comando crea un nuevo recurso de prefijo de DIRECCIÓN IP pública global.
Ejemplo 3
Crea un prefijo de dirección IP pública. (autogenerated)
New-AzPublicIpPrefix -CustomIpPrefix <PSCustomIpPrefix> -Location 'West US' -Name 'MyPublicIPPrefix' -PrefixLength '31' -ResourceGroupName 'MyResourceGroup'
Ejemplo 4: Creación de un prefijo de dirección IP pública asociado a una etiqueta de servicio de primera entidad
$serviceTag = Get-AzFirstPartyServiceTag -ResourceGroupName "ContosoResourceGroup" -Name "ContosoServiceTag"
$ipTag = [Microsoft.Azure.Commands.Network.Models.PSPublicIpPrefixTag]@{
IpTagType = "FirstPartyUsage"
Tag = "/Sql"
FirstPartyServiceTagId = $serviceTag.Id
}
$publicIpPrefix = New-AzPublicIpPrefix -Name "ContosoPublicIpPrefix" -ResourceGroupName "ContosoResourceGroup" -Location "eastus" -PrefixLength 30 -IpTag $ipTag
Este comando crea un prefijo de dirección IP pública cuya etiqueta IP está asociada a una etiqueta de servicio de primera entidad.
Parámetros
-AcquirePolicyToken
Adquiera automáticamente un token de Azure Policy para esta operación de recursos.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False 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 Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-ChangeReference
Identificador de recurso de referencia de cambio para esta operación de recurso.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: 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: None Admite caracteres comodín: False DontShow: False Alias: cf
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-CustomIpPrefix
CustomIpPrefix al que se asociará este publicIpPrefix.
Propiedades de parámetro
Tipo: PSCustomIpPrefix
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: 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 Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-EdgeZone
Zona perimetral del prefijo de 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 Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-Force
No solicite confirmación si desea sobrescribir un recurso
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-IpAddressVersion
Versión de la dirección IP pública.
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 Mandatory: 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: PSPublicIpPrefixTag [ ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-Location
Ubicación del prefijo 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 Mandatory: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-Name
Nombre del recurso.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: ResourceName
Conjuntos de parámetros
(All)
Posición: Named Mandatory: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-PrefixLength
Longitud de PublicIPPrefix
Propiedades de parámetro
Tipo: UInt16
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-ResourceGroupName
El nombre del grupo de recursos.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: True 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 prefijo de DIRECCIÓN IP pública.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Valores aceptados: Standard, StandardV2 Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-Tag
Tabla hash que representa etiquetas de recursos.
Propiedades de parámetro
Tipo: Hashtable
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: 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 prefijo 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 Mandatory: 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: None Admite caracteres comodín: False DontShow: False Alias: wi
Conjuntos de parámetros
(All)
Posición: Named Mandatory: 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 Mandatory: 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 .
Salidas
