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[]
Utdata
Relaterade länkar
Azure PowerShell