New-AzureRmPublicIpAddress

Vytvoří veřejnou IP adresu.

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntax

New-AzureRmPublicIpAddress
   [-Name <String>]
   -ResourceGroupName <String>
   [-Location <String>]
   [-Sku <String>]
   -AllocationMethod <String>
   [-IpAddressVersion <String>]
   [-DomainNameLabel <String>]
   [-IpTag <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag]>]
   [-PublicIpPrefix <Microsoft.Azure.Commands.Network.Models.PSPublicIpPrefix>]
   [-ReverseFqdn <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-Zone <System.Collections.Generic.List`1[System.String]>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina New-AzureRmPublicIpAddress vytvoří veřejnou IP adresu.

Příklady

1: Vytvoření nové veřejné IP adresy

$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location

Tento příkaz vytvoří nový prostředek veřejné IP adresy. Vytvoří se záznam DNS pro $dnsPrefix.$location.cloudapp.azure.com odkazující na veřejnou IP adresu tohoto prostředku. Veřejné IP adresy se k tomuto prostředku okamžitě přidělí, protože parametr -AllocationMethod je zadaný jako statická. Pokud je zadaná jako dynamická, přidělí se veřejná IP adresa pouze při spuštění (nebo vytvoření) přidruženého prostředku (například virtuálního počítače nebo nástroje pro vyrovnávání zatížení).

2: Vytvoření veřejné IP adresy s reverzním plně kvalifikovaným názvem domény

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

Tento příkaz vytvoří nový prostředek veřejné IP adresy. S parametrem -ReverseFqdn vytvoří Azure záznam PTR DNS (reverzní vyhledávání) pro veřejnou IP adresu přidělenou tomuto prostředku, který ukazuje na $customFqdn zadaný v příkazu. Předpokladem je, že $customFqdn (řekněme webapp.contoso.com) by měl obsahovat záznam DNS CNAME (dopředné vyhledávání) odkazující na $dnsPrefix.$location.cloudapp.azure.com.

3: Vytvoření nové veřejné IP adresy s IpTagem

$ipTag = New-AzureRmPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTags ipTag

Tento příkaz vytvoří nový prostředek veřejné IP adresy. Vytvoří se záznam DNS pro $dnsPrefix.$location.cloudapp.azure.com odkazující na veřejnou IP adresu tohoto prostředku. Veřejné IP adresy se k tomuto prostředku okamžitě přidělí, protože parametr -AllocationMethod je zadaný jako statická. Pokud je zadaná jako dynamická, přidělí se veřejná IP adresa pouze při spuštění (nebo vytvoření) přidruženého prostředku (například virtuálního počítače nebo nástroje pro vyrovnávání zatížení). Iptag se používá k určení značek přidružených k prostředku. Iptag je možné zadat pomocí New-AzureRmPublicIpTag a předat ji jako vstup prostřednictvím -IpTags.

4: Vytvoření nové veřejné IP adresy z předpony

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

Tento příkaz vytvoří nový prostředek veřejné IP adresy. Vytvoří se záznam DNS pro $dnsPrefix.$location.cloudapp.azure.com odkazující na veřejnou IP adresu tohoto prostředku. Veřejná IP adresa se okamžitě přidělí tomuto prostředku ze zadaného publicIpPrefixu. Tato možnost je podporována pouze pro skladovou položku Standard a Static AllocationMethod.

Parametry

-AllocationMethod

Určuje metodu, se kterou se má přidělit veřejná IP adresa. Přijatelné hodnoty pro tento parametr jsou: Static nebo Dynamic.

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

-AsJob

Spuštění rutiny na pozadí

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

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

-DomainNameLabel

Určuje relativní název DNS pro veřejnou IP adresu.

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

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

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

-IdleTimeoutInMinutes

Určuje časový limit nečinnosti v minutách.

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

-IpAddressVersion

Určuje verzi IP adresy.

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

-IpTag

Seznam iptagů

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

-Location

Určuje oblast, ve které se má vytvořit veřejná IP adresa.

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

-Name

Určuje název veřejné IP adresy, kterou tato rutina vytvoří.

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

-PublicIpPrefix

Určuje PSPublicIpPrefix, ze kterého se má přidělit veřejná IP adresa.

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

-ResourceGroupName

Určuje název skupiny prostředků, ve které se má vytvořit veřejná IP adresa.

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

-ReverseFqdn

Určuje reverzní plně kvalifikovaný název domény (FQDN).

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

-Sku

Název skladové položky veřejné IP adresy.

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

-Tag

Páry klíč-hodnota ve formě tabulky hash. Příklad: @{key0="value0"; key1=$null; key2="value2"}

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

-Zone

Seznam zón dostupnosti označující IP adresu přidělenou pro prostředek, ze které musí pocházet.

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

Vstupy

String

List<T>[[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Int32

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Hashtable

Výstupy

PSPublicIpAddress