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 <String>][-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. Für $dnsPrefix.$location.cloudapp.azure.com, der auf die öffentliche IP-Adresse dieser Ressource verweist, wird ein DNS-Eintrag erstellt. 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. Für $dnsPrefix.$location.cloudapp.azure.com, der auf die öffentliche IP-Adresse dieser Ressource verweist, wird ein DNS-Eintrag erstellt. 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. Für $dnsPrefix.$location.cloudapp.azure.com, der auf die öffentliche IP-Adresse dieser Ressource verweist, wird ein DNS-Eintrag erstellt. 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. Für $dnsPrefix.$location.cloudapp.azure.com, der auf die öffentliche IP-Adresse dieser Ressource verweist, wird ein DNS-Eintrag erstellt. 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 Do Standard NameLabelScope

$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 "-Do Standard NameLabelScope" 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.

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

-AsJob

Cmdlet im Hintergrund ausführen

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

-Confirm

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

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

-DdosProtectionMode

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

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

-DdosProtectionPlanId

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

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

-DefaultProfile

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

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

-DomainNameLabel

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

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

-DomainNameLabelScope

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

Type:String
Accepted values:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EdgeZone

Der Name des erweiterten Speicherorts.

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

-Force

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

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

-IdleTimeoutInMinutes

Gibt das Leerlauftimeout in Minuten an.

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

-IpAddress

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

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

-IpAddressVersion

Gibt die Version der IP-Adresse an.

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

-IpTag

IpTag-Liste.

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

-Location

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

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

-Name

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

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

-PublicIpPrefix

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

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

-ResourceGroupName

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

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

-ReverseFqdn

Gibt einen umgekehrten vollqualifizierten Do Standard Namen (FQDN) an.

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

-Sku

Der name der öffentlichen IP-Sku.

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

-Tag

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

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

-Tier

Die öffentliche IP-Sku-Ebene.

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

-WhatIf

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

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

-Zone

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

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

Eingaben

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Ausgaben

PSPublicIpAddress