Dela via


New-AzureRmPublicIpAddress

Skapar en offentlig IP-adress.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

New-AzureRmPublicIpAddress
   [-Name <String>]
   -ResourceGroupName <String>
   [-Location <String>]
   [-Sku <String>]
   -AllocationMethod <String>
   [-IpAddressVersion <String>]
   [-DomainNameLabel <String>]
   [-IpTag <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag]>]
   [-PublicIpPrefix <Microsoft.Azure.Commands.Network.Models.PSPublicIpPrefix>]
   [-ReverseFqdn <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-Zone <System.Collections.Generic.List`1[System.String]>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten New-AzureRmPublicIpAddress skapar en offentlig IP-adress.

Exempel

1: Skapa en ny offentlig IP-adress

$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location

Det här kommandot skapar en ny offentlig IP-adressresurs. En DNS-post skapas för $dnsPrefix.$location.cloudapp.azure.com som pekar på resursens offentliga IP-adress. En offentlig IP-adress allokeras omedelbart till den här resursen eftersom -AllocationMethod anges som "Statisk". Om den anges som "dynamisk" allokeras en offentlig IP-adress endast när du startar (eller skapar) den associerade resursen (till exempel en virtuell dator eller lastbalanserare).

2: Skapa en offentlig IP-adress med omvänd FQDN

$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -ReverseFqdn $customFqdn

Det här kommandot skapar en ny offentlig IP-adressresurs. Med parametern -ReverseFqdn skapar Azure en DNS PTR-post (omvänd sökning) för den offentliga IP-adress som allokerats till den här resursen och pekar på den $customFqdn som anges i kommandot. Som en förutsättning bör $customFqdn (till exempel webapp.contoso.com) ha en DNS CNAME-post (framåtsökning) som pekar på $dnsPrefix.$location.cloudapp.azure.com.

3: Skapa en ny offentlig IP-adress med IpTag

$ipTag = New-AzureRmPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTags ipTag

Det här kommandot skapar en ny offentlig IP-adressresurs. En DNS-post skapas för $dnsPrefix.$location.cloudapp.azure.com som pekar på resursens offentliga IP-adress. En offentlig IP-adress allokeras omedelbart till den här resursen eftersom -AllocationMethod anges som "Statisk". Om den anges som "dynamisk" allokeras en offentlig IP-adress endast när du startar (eller skapar) den associerade resursen (till exempel en virtuell dator eller lastbalanserare). En Iptag används för att specifika taggar som är associerade med resursen. Iptag kan anges med New-AzureRmPublicIpTag och skickas som indata via -IpTags.

4: Skapa en ny offentlig IP-adress från ett prefix

$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location
-PublicIpPrefix publicIpPrefix -Sku Standard

Det här kommandot skapar en ny offentlig IP-adressresurs. En DNS-post skapas för $dnsPrefix.$location.cloudapp.azure.com som pekar på resursens offentliga IP-adress. En offentlig IP-adress allokeras omedelbart till den här resursen från det publicIpPrefix som angetts. Det här alternativet stöds endast för "Standard" Sku och "Static" AllocationMethod.

Parametrar

-AllocationMethod

Anger med vilken metod den offentliga IP-adressen ska allokeras. De acceptabla värdena för den här parametern är: Statisk eller Dynamisk.

Typ:String
Godkända värden:Dynamic, Static
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AsJob

Kör cmdlet i bakgrunden

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DomainNameLabel

Anger det relativa DNS-namnet för en offentlig IP-adress.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IdleTimeoutInMinutes

Anger tidsgränsen för inaktivitet i minuter.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-IpAddressVersion

Anger ip-adressens version.

Typ:String
Godkända värden:IPv4, IPv6
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-IpTag

IpTag-lista.

Typ:List<T>[PSPublicIpTag]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Location

Anger i vilken region en offentlig IP-adress ska skapas.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnet på den offentliga IP-adress som den här cmdleten skapar.

Typ:String
Alias:ResourceName
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PublicIpPrefix

Anger PSPublicIpPrefix som den offentliga IP-adressen ska allokeras från.

Typ:PSPublicIpPrefix
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceGroupName

Anger namnet på resursgruppen där en offentlig IP-adress ska skapas.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ReverseFqdn

Anger ett fullständigt domännamn (FQDN).

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Sku

Det offentliga IP-SKU-namnet.

Typ:String
Godkända värden:Basic, Standard
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Tag

Nyckel/värde-par i form av en hash-tabell. Exempel: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Zone

En lista över tillgänglighetszoner som anger den IP-adress som allokerats för resursen måste komma från.

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

String

List<T>[[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Int32

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Hashtable

Utdata

PSPublicIpAddress