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.

Type:String
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-AsJob

Kör cmdlet i bakgrunden

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DdosProtectionMode

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

Type:String
Accepted values:VirtualNetworkInherited, Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DdosProtectionPlanId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainNameLabel

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DomainNameLabelScope

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

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

Namnet på den utökade platsen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdleTimeoutInMinutes

Anger tidsgränsen för inaktivitet i minuter.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IpAddress

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IpAddressVersion

Anger ip-adressens version.

Type:String
Accepted values:IPv4, IPv6
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IpTag

IpTag-lista.

Type:PSPublicIpTag[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Aliases:ResourceName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicIpPrefix

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

Type:PSPublicIpPrefix
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReverseFqdn

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Sku

Det offentliga IP-SKU-namnet.

Type:String
Accepted values:Basic, Standard
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

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

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tier

Den offentliga IP-SKU-nivån.

Type:String
Accepted values:Regional, Global
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Indata

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Utdata

PSPublicIpAddress