New-AzPublicIpAddress

  • Referenz
Modul:
Az.Network

Erstellt eine öffentliche IP-Adresse.

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

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 zugeordnet, da "-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 zugeordnet, da "-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.

Typ:String
Zulässige Werte:Dynamic, Static
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-AsJob

Cmdlet im Hintergrund ausführen

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DdosProtectionMode

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

Typ:String
Zulässige Werte:VirtualNetworkInherited, Enabled, Disabled
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DdosProtectionPlanId

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DomainNameLabel

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DomainNameLabelScope

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

Typ:Nullable<T>[PSDomainNameLabelScopeType]
Zulässige Werte:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-EdgeZone

Der Name des erweiterten Speicherorts.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IdleTimeoutInMinutes

Gibt das Leerlauftimeout in Minuten an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-IpAddress

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-IpAddressVersion

Gibt die Version der IP-Adresse an.

Typ:String
Zulässige Werte:IPv4, IPv6
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-IpTag

IpTag-Liste.

Typ:PSPublicIpTag[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Location

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

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

Typ:String
Aliase:ResourceName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PublicIpPrefix

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

Typ:PSPublicIpPrefix
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ReverseFqdn

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Sku

Der name der öffentlichen IP-Sku.

Typ:String
Zulässige Werte:Basic, Standard
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Tag

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

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Tier

Die öffentliche IP-Sku-Ebene.

Typ:String
Zulässige Werte:Regional, Global
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Zone

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

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Ausgaben

PSPublicIpAddress