New-AzPublicIpAddress
Vytvoří veřejnou IP adresu.
Syntaxe
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>]
Description
Rutina New-AzPublicIpAddress vytvoří veřejnou IP adresu.
Příklady
Příklad 1: Vytvoření nové veřejné IP adresy
$publicIp = New-AzPublicIpAddress -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í).
Příklad 2: Vytvoření veřejné IP adresy s reverzním plně kvalifikovaným názvem domény
$publicIp = New-AzPublicIpAddress -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.
Příklad 3: Vytvoření nové veřejné IP adresy se značkou IpTag
$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $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 lze zadat pomocí New-AzPublicIpTag a předat jako vstup prostřednictvím -IpTags.
Příklad 4: Vytvoření nové veřejné IP adresy z předpony
$publicIp = New-AzPublicIpAddress -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.
Příklad 5: Vytvoření konkrétní veřejné IP adresy z předpony BYOIP
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -Location $location -IpAddress 0.0.0.0 -PublicIpPrefix $publicIpPrefix -Sku Standard
Tento příkaz vytvoří nový prostředek veřejné IP adresy s konkrétní IP adresou. NRP zkontroluje, jestli se daná IP adresa nachází uvnitř publicIpPrefixu a jestli je daná hodnota PublicIpPrefix BYOIP PublicIpPrefix. daná 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 StaticKá PřiděleníMethod a BYOIP PublicIpPrefix.
Příklad 6: Vytvoření nové globální veřejné IP adresy
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $domainNameLabel -Location $location -Sku Standard -Tier Global
Tento příkaz vytvoří nový globální 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. K tomuto prostředku se okamžitě přidělí globální veřejná IP adresa. Tato možnost je podporována pouze pro skladovou položku Standard a Static AllocationMethod.
Příklad 7: Vytvoření veřejné IP adresy pomocí DomainNameLabelScope
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $location
Tento příkaz vytvoří nový prostředek veřejné IP adresy. S parametrem -DomainNameLabelScope vytvoří Azure záznam DNS s hodnotou hash v plně kvalifikovaném názvu domény pro veřejnou IP adresu přidělenou tomuto prostředku se zásadami navrhovanými $hasedReusePolicy.
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.
Typ: | String |
Přípustné hodnoty: | Dynamic, Static |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-AsJob
Spuštění rutiny na pozadí
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DdosProtectionMode
DdosProtectionMode, který se má použít pro veřejnou IP adresu
Typ: | String |
Přípustné hodnoty: | VirtualNetworkInherited, Enabled, Disabled |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-DdosProtectionPlanId
ID DdosProtectionPlan pro připojení k veřejné IP adrese
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DomainNameLabel
Určuje relativní název DNS pro veřejnou IP adresu.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-DomainNameLabelScope
Určuje HashedReusePolicy pro název DNS pro veřejnou IP adresu.
Typ: | Nullable<T>[PSDomainNameLabelScopeType] |
Přípustné hodnoty: | TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-EdgeZone
Název rozšířeného umístění.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Force
Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-IdleTimeoutInMinutes
Určuje časový limit nečinnosti v minutách.
Typ: | Int32 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-IpAddress
Určuje IP adresu při vytváření BYOIP publicIpAddress.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-IpAddressVersion
Určuje verzi IP adresy.
Typ: | String |
Přípustné hodnoty: | IPv4, IPv6 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-IpTag
Seznam iptagů
Typ: | PSPublicIpTag[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Location
Určuje oblast, ve které se má vytvořit veřejná IP adresa.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Name
Určuje název veřejné IP adresy, kterou tato rutina vytvoří.
Typ: | String |
Aliasy: | ResourceName |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-PublicIpPrefix
Určuje PSPublicIpPrefix, ze kterého se má přidělit veřejná IP adresa.
Typ: | PSPublicIpPrefix |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ResourceGroupName
Určuje název skupiny prostředků, ve které se má vytvořit veřejná IP adresa.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ReverseFqdn
Určuje reverzní plně kvalifikovaný název domény (FQDN).
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Sku
Název skladové položky veřejné IP adresy.
Typ: | String |
Přípustné hodnoty: | Basic, Standard |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Tag
Páry klíč-hodnota ve formě tabulky hash. Příklad: @{key0="value0"; key1=$null; key2="value2"}
Typ: | Hashtable |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Tier
Úroveň skladové položky veřejné IP adresy.
Typ: | String |
Přípustné hodnoty: | Regional, Global |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Zone
Seznam zón dostupnosti označující IP adresu přidělenou pro prostředek, ze které musí pocházet.
Typ: | String[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
Vstupy
String[]
Výstupy
Související odkazy
Azure PowerShell