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[]