Freigeben über

New-AzPublicIpAddress

Modul:
Az.Network Module

Erstellt eine öffentliche IP-Adresse.

Syntax

Default (Standardwert) 

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

Beschreibung

Das Cmdlet New-AzPublicIpAddress erstellt eine öffentliche IP-Adresse.

Beispiele

Beispiel 1: Erstellen einer neuen öffentlichen IP-Adresse

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $___location

Mit diesem Befehl wird eine neue öffentliche IP-Adressressource erstellt. Es wird ein DNS-Eintrag für $dnsPrefix.$___location.cloudapp.azure.com erstellt, der auf die öffentliche IP-Adresse dieser Ressource verweist. Dieser Ressource wird sofort eine öffentliche IP-Adresse zugewiesen, da die -AllocationMethod als "Static" angegeben wird. Wenn sie als "Dynamisch" angegeben ist, wird eine öffentliche IP-Adresse nur zugewiesen, wenn Sie die zugeordnete Ressource (z. B. eine VM oder ein Lastenausgleich) starten (oder erstellen).

Beispiel 2: Erstellen einer öffentlichen IP-Adresse mit einem umgekehrten FQDN

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

Mit diesem Befehl wird eine neue öffentliche IP-Adressressource erstellt. Mit dem parameter -ReverseFqdn erstellt Azure einen DNS-PTR-Eintrag (Reverse-Lookup) für die öffentliche IP-Adresse, die dieser Ressource zugeordnet ist, und verweist auf die im Befehl angegebene $customFqdn. Als Voraussetzung sollte die $customFqdn (z. B. webapp.contoso.com) einen DNS-CNAME-Eintrag (Forward-Lookup) aufweisen, der auf $dnsPrefix.$___location.cloudapp.azure.com verweist.

Beispiel 3: Erstellen einer neuen öffentlichen IP-Adresse mit IpTag

$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $___location -IpTag $ipTag

Mit diesem Befehl wird eine neue öffentliche IP-Adressressource erstellt. Es wird ein DNS-Eintrag für $dnsPrefix.$___location.cloudapp.azure.com erstellt, der auf die öffentliche IP-Adresse dieser Ressource verweist. Dieser Ressource wird sofort eine öffentliche IP-Adresse zugewiesen, da die -AllocationMethod als "Static" angegeben wird. Wenn sie als "Dynamisch" angegeben ist, wird eine öffentliche IP-Adresse nur zugewiesen, wenn Sie die zugeordnete Ressource (z. B. eine VM oder ein Lastenausgleich) starten (oder erstellen). Ein Iptag wird verwendet, um die tags zuzuordnen, die der Ressource zugeordnet sind. Iptag kann mithilfe von New-AzPublicIpTag angegeben und als Eingabe über -IpTags übergeben werden.

Beispiel 4: Erstellen einer neuen öffentlichen IP-Adresse aus einem Präfix

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

Mit diesem Befehl wird eine neue öffentliche IP-Adressressource erstellt. Es wird ein DNS-Eintrag für $dnsPrefix.$___location.cloudapp.azure.com erstellt, der auf die öffentliche IP-Adresse dieser Ressource verweist. Dieser Ressource wird sofort eine öffentliche IP-Adresse aus dem angegebenen publicIpPrefix zugeordnet. Diese Option wird nur für die Sku "Standard" und "Static" AllocationMethod unterstützt.

Beispiel 5: Erstellen einer bestimmten öffentlichen IP-Adresse aus einem BYOIP-Präfix

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

Mit diesem Befehl wird eine neue öffentliche IP-Adressressource mit einer bestimmten IP erstellt. Die NRP überprüft, ob sich die angegebene IP innerhalb von PublicIpPrefix befindet und ob es sich bei dem angegebenen PublicIpPrefix um BYOIP PublicIpPrefix handelt. die angegebene öffentliche IP-Adresse wird dieser Ressource sofort aus dem angegebenen publicIpPrefix zugeordnet. Diese Option wird nur für die Sku "Standard" und "Static" AllocationMethod und BYOIP PublicIpPrefix unterstützt.

Beispiel 6: Erstellen einer neuen globalen öffentlichen IP-Adresse

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

Mit diesem Befehl wird eine neue globale öffentliche IP-Adressressource erstellt. Es wird ein DNS-Eintrag für $dnsPrefix.$___location.cloudapp.azure.com erstellt, der auf die öffentliche IP-Adresse dieser Ressource verweist. Dieser Ressource wird sofort eine globale öffentliche IP-Adresse zugeordnet. Diese Option wird nur für die Sku "Standard" und "Static" AllocationMethod unterstützt.

Beispiel 7: Erstellen einer öffentlichen IP-Adresse mit einem DomainNameLabelScope

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

Mit diesem Befehl wird eine neue öffentliche IP-Adressressource erstellt. Mit dem parameter -DomainNameLabelScope erstellt Azure einen DNS-Eintrag mit einem Hashwert in FQDN für die öffentliche IP-Adresse, die dieser Ressource zugeordnet ist, mit der von $hasedReusePolicy vorgeschlagenen Richtlinie.

Parameter

-AllocationMethod

Gibt die Methode an, mit der die öffentliche IP-Adresse zugewiesen werden soll. Die zulässigen Werte für diesen Parameter sind: Statisch oder dynamisch.

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:Dynamic, Static
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-AsJob

Cmdlet im Hintergrund ausführen

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DdosProtectionMode

Der für die öffentliche IP-Adresse zu verwendende DdosProtectionMode

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:VirtualNetworkInherited, Enabled, Disabled
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DdosProtectionPlanId

Die DdosProtectionPlan-ID, die an die öffentliche IP-Adresse angefügt werden soll

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DomainNameLabel

Gibt den relativen DNS-Namen für eine öffentliche IP-Adresse an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DomainNameLabelScope

Gibt die HashedReusePolicy für DNS-Namen für eine öffentliche IP-Adresse an.

Parametereigenschaften

Typ:

Nullable<T>[PSDomainNameLabelScopeType]

Standardwert:None
Zulässige Werte:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-EdgeZone

Der Name des erweiterten Speicherorts.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IdleTimeoutInMinutes

Gibt das Leerlauftimeout in Minuten an.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-IpAddress

Gibt die IP-Adresse beim Erstellen einer BYOIP publicIpAddress an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-IpAddressVersion

Gibt die Version der IP-Adresse an.

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:IPv4, IPv6
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-IpTag

IpTag-Liste.

Parametereigenschaften

Typ:

PSPublicIpTag[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Location

Gibt die Region an, in der eine öffentliche IP-Adresse erstellt werden soll.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen der öffentlichen IP-Adresse an, die dieses Cmdlet erstellt.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Ressourcenname

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-PublicIpPrefix

Gibt das PSPublicIpPrefix an, aus dem die öffentliche IP-Adresse zugewiesen werden soll.

Parametereigenschaften

Typ:PSPublicIpPrefix
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, in der eine öffentliche IP-Adresse erstellt werden soll.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ReverseFqdn

Gibt einen umgekehrten vollqualifizierten Domänennamen (FQDN) an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Sku

Der name der öffentlichen IP-Sku.

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:Basic, Standard, StandardV2
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Tag

Schlüssel-Wert-Paare in Form einer Hashtabelle. Beispiel: @{key0="value0"; key1=$null; key2="value2"}

Parametereigenschaften

Typ:Hashtable
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Tier

Die öffentliche IP-Sku-Ebene.

Parametereigenschaften

Typ:String
Standardwert:None
Zulässige Werte:Regional, Global
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Zone

Eine Liste der Verfügbarkeitszonen, aus der die für die Ressource zugeordnete IP-Adresse angegeben wird.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

PSPublicIpTag

PSPublicIpPrefix

Int32

String

Hashtable

Ausgaben

PSPublicIpAddress