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
List<T>[[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]