Dela via


New-AzPublicIpAddress

Skapar en offentlig IP-adress.

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

Cmdleten New-AzPublicIpAddress skapar en offentlig IP-adress.

Exempel

Exempel 1: Skapa en ny offentlig IP-adress

$publicIp = New-AzPublicIpAddress -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).

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

$publicIp = New-AzPublicIpAddress -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.

Exempel 3: Skapa en ny offentlig IP-adress med IpTag

$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $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-AzPublicIpTag och skickas som indata via -IpTags.

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

$publicIp = New-AzPublicIpAddress -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.

Exempel 5: Skapa en specifik offentlig IP-adress från ett BYOIP-prefix

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -Location $location -IpAddress 0.0.0.0 -PublicIpPrefix $publicIpPrefix -Sku Standard

Det här kommandot skapar en ny offentlig IP-adressresurs med specifik IP-adress. NRP kontrollerar om den angivna IP-adressen finns i PublicIpPrefix och om det angivna PublicIpPrefixet är BYOIP PublicIpPrefix. den angivna offentliga IP-adressen allokeras omedelbart till den här resursen från det angivna publicIpPrefix. Det här alternativet stöds endast för "Standard" Sku och "Static" AllocationMethod och BYOIP PublicIpPrefix.

Exempel 6: Skapa en ny global offentlig IP-adress

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $domainNameLabel -Location $location -Sku Standard -Tier Global

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

Exempel 7: Skapa en offentlig IP-adress med ett DomainNameLabelScope

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $location

Det här kommandot skapar en ny offentlig IP-adressresurs. Med parametern -DomainNameLabelScope skapar Azure en DNS-post med ett hashvärde i FQDN för den offentliga IP-adress som allokerats till den här resursen med principen som föreslås av $hasedReusePolicy.

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

-DdosProtectionMode

DdosProtectionMode som ska användas för offentlig IP-adress

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

-DdosProtectionPlanId

DdosProtectionPlan-ID:t som ska kopplas till den offentliga IP-adressen

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

-DefaultProfile

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

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

-DomainNameLabelScope

Anger HashedReusePolicy för DNS-namn för en offentlig IP-adress.

Typ:Nullable<T>[PSDomainNameLabelScopeType]
Godkända värden:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-EdgeZone

Namnet på den utökade platsen.

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

-IpAddress

Anger IP-adressen när du skapar en BYOIP publicIpAddress.

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

-Tier

Den offentliga IP-SKU-nivån.

Typ:String
Godkända värden:Regional, Global
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:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Utdata

PSPublicIpAddress