New-AzPublicIpAddress
Cria um endereço IP público.
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
O cmdlet New-AzPublicIpAddress cria um endereço IP público.
Exemplos
Exemplo 1: Criar um novo endereço IP público
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $locationEsse comando cria um novo recurso de endereço IP público. Um registro DNS é criado para $dnsPrefix.$location.cloudapp.azure.com que aponte para o endereço IP público desse recurso. Um endereço IP público é imediatamente alocado a esse recurso, pois o -AllocationMethod é especificado como 'Estático'. Se for especificado como 'Dinâmico', um endereço IP público será alocado somente quando você iniciar (ou criar) o recurso associado (como uma VM ou balanceador de carga).
Exemplo 2: Criar um endereço IP público com um FQDN reverso
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -ReverseFqdn $customFqdnEsse comando cria um novo recurso de endereço IP público. Com o parâmetro -ReverseFqdn, o Azure cria um registro PTR DNS (pesquisa reversa) para o endereço IP público alocado para esse recurso, apontando para o $customFqdn especificado no comando. Como pré-requisito, o $customFqdn (digamos webapp.contoso.com) deve ter um registro DNS CNAME (pesquisa direta) apontando para $dnsPrefix.$location.cloudapp.azure.com.
Exemplo 3: Criar um novo endereço IP público com IpTag
$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $ipTagEsse comando cria um novo recurso de endereço IP público. Um registro DNS é criado para $dnsPrefix.$location.cloudapp.azure.com que aponte para o endereço IP público desse recurso. Um endereço IP público é imediatamente alocado a esse recurso, pois o -AllocationMethod é especificado como 'Estático'. Se for especificado como 'Dinâmico', um endereço IP público será alocado somente quando você iniciar (ou criar) o recurso associado (como uma VM ou balanceador de carga). Um Iptag é usado para especificar as Tags associadas ao recurso. Iptag pode ser especificado usando New-AzPublicIpTag e passado como entrada através de -IpTags.
Exemplo 4: Criar um novo endereço IP público a partir de um prefixo
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -PublicIpPrefix $publicIpPrefix -Sku StandardEsse comando cria um novo recurso de endereço IP público. Um registro DNS é criado para $dnsPrefix.$location.cloudapp.azure.com que aponte para o endereço IP público desse recurso. Um endereço IP público é imediatamente alocado a esse recurso a partir do publicIpPrefix especificado. Esta opção só é suportada para o Sku 'Standard' e 'Static' AllocationMethod.
Exemplo 5: Criar um endereço IP público específico a partir de um prefixo BYOIP
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -Location $location -IpAddress 0.0.0.0 -PublicIpPrefix $publicIpPrefix -Sku StandardEsse comando cria um novo recurso de endereço IP público com IP específico. O NRP verificaria se o IP fornecido está dentro do PublicIpPrefix e se o PublicIpPrefix fornecido é BYOIP PublicIpPrefix. o endereço IP público fornecido é imediatamente alocado a esse recurso a partir do publicIpPrefix especificado. Esta opção só é suportada para o Sku 'Standard' e 'Static' AllocationMethod e BYOIP PublicIpPrefix.
Exemplo 6: Criar um novo endereço IP público global
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $domainNameLabel -Location $location -Sku Standard -Tier GlobalEsse comando cria um novo recurso de endereço IP público global. Um registro DNS é criado para $dnsPrefix.$location.cloudapp.azure.com que aponte para o endereço IP público desse recurso. Um endereço IP público global é imediatamente alocado a esse recurso. Esta opção só é suportada para o Sku 'Standard' e 'Static' AllocationMethod.
Exemplo 7: Criar um endereço IP público com um DomainNameLabelScope
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $locationEsse comando cria um novo recurso de endereço IP público. Com o parâmetro -DomainNameLabelScope, o Azure cria um registro DNS com um valor hash no FQDN para o endereço IP público alocado a esse recurso com a política sugerida por $hasedReusePolicy.
Parâmetros
-AllocationMethod
Especifica o método com o qual alocar o endereço IP público. Os valores aceitáveis para esse parâmetro são: Estático ou Dinâmico.
| Type: | String |
| Accepted values: | Dynamic, Static |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AsJob
Executar cmdlet em segundo plano
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DdosProtectionMode
O DdosProtectionMode a ser usado para endereço IP público
| Type: | String |
| Accepted values: | VirtualNetworkInherited, Enabled, Disabled |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DdosProtectionPlanId
A ID DdosProtectionPlan a ser anexada ao endereço IP público
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainNameLabel
Especifica o nome DNS relativo para um endereço IP público.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DomainNameLabelScope
Especifica o HashedReusePolicy para nome DNS para um endereço IP público.
| 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
O nome do local estendido.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdleTimeoutInMinutes
Especifica o tempo limite ocioso, em minutos.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IpAddress
Especifica o endereço IP ao criar um BYOIP publicIpAddress.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IpAddressVersion
Especifica a versão do endereço IP.
| Type: | String |
| Accepted values: | IPv4, IPv6 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IpTag
Lista IpTag.
| Type: | PSPublicIpTag[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Location
Especifica a região na qual criar um endereço IP público.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica o nome do endereço IP público que esse cmdlet cria.
| Type: | String |
| Aliases: | ResourceName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PublicIpPrefix
Especifica o PSPublicIpPrefix a partir do qual alocar o endereço IP público.
| Type: | PSPublicIpPrefix |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
Especifica o nome do grupo de recursos no qual criar um endereço IP público.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReverseFqdn
Especifica um FQDN (nome de domínio totalmente qualificado) reverso.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Sku
O nome público do IP Sku.
| Type: | String |
| Accepted values: | Basic, Standard |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tag
Pares chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; chave1=$null; key2="valor2"}
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tier
A camada 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
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Zone
Uma lista de zonas de disponibilidade que indica o IP alocado para o recurso precisa vir de.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Entradas
String[]
Saídas
Links Relacionados
Azure PowerShell
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de