Udostępnij przez

New-AzPublicIpAddress

Moduł:
Az.Network Module

Tworzy publiczny adres IP.

Składnia

Default (domyślnie) 

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

Opis

Polecenie cmdlet New-AzPublicIpAddress tworzy publiczny adres IP.

Przykłady

Przykład 1. Tworzenie nowego publicznego adresu IP

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

To polecenie tworzy nowy zasób publicznego adresu IP. Rekord DNS jest tworzony dla $dnsPrefix.$location.cloudapp.azure.com wskazujący publiczny adres IP tego zasobu. Publiczny adres IP jest natychmiast przydzielany do tego zasobu, ponieważ -AllocationMethod jest określony jako "Statyczny". Jeśli zostanie określony jako "Dynamiczny", publiczny adres IP zostanie przydzielony tylko po uruchomieniu (lub utworzeniu) skojarzonego zasobu (na przykład maszyny wirtualnej lub modułu równoważenia obciążenia).

Przykład 2. Tworzenie publicznego adresu IP z odwrotną nazwą FQDN

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

To polecenie tworzy nowy zasób publicznego adresu IP. Za pomocą parametru -ReverseFqdn platforma Azure tworzy rekord PTR DNS (wyszukiwanie wsteczne) dla publicznego adresu IP przydzielonego do tego zasobu, wskazując $customFqdn określony w poleceniu . Jako warunek wstępny, $customFqdn (powiedzmy, webapp.contoso.com) powinien mieć rekord CNAME DNS (wyszukiwanie do przodu) wskazujący na $dnsPrefix.$location.cloudapp.azure.com.

Przykład 3. Tworzenie nowego publicznego adresu IP przy użyciu elementu IpTag

$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $ipTag

To polecenie tworzy nowy zasób publicznego adresu IP. Rekord DNS jest tworzony dla $dnsPrefix.$location.cloudapp.azure.com wskazujący publiczny adres IP tego zasobu. Publiczny adres IP jest natychmiast przydzielany do tego zasobu, ponieważ -AllocationMethod jest określony jako "Statyczny". Jeśli zostanie określony jako "Dynamiczny", publiczny adres IP zostanie przydzielony tylko po uruchomieniu (lub utworzeniu) skojarzonego zasobu (na przykład maszyny wirtualnej lub modułu równoważenia obciążenia). Element Iptag służy do określania tagów skojarzonych z zasobem. Adres IPtag można określić przy użyciu New-AzPublicIpTag i przekazać jako dane wejściowe za pośrednictwem -IpTags.

Przykład 4. Tworzenie nowego publicznego adresu IP na podstawie prefiksu

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

To polecenie tworzy nowy zasób publicznego adresu IP. Rekord DNS jest tworzony dla $dnsPrefix.$location.cloudapp.azure.com wskazujący publiczny adres IP tego zasobu. Publiczny adres IP jest natychmiast przydzielany do tego zasobu z określonego publicznego prefiksuIpPrefix. Ta opcja jest obsługiwana tylko w przypadku jednostek SKU w warstwie Standardowa i alokacji statycznejMethod.

Przykład 5. Tworzenie określonego publicznego adresu IP na podstawie prefiksu BYOIP

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -Location $location -IpAddress 0.0.0.0 -PublicIpPrefix $publicIpPrefix -Sku Standard

To polecenie tworzy nowy zasób publicznego adresu IP z określonym adresem IP. NrP sprawdzi, czy dany adres IP znajduje się wewnątrz prefiksu PublicIpPrefix i czy dany prefiks PublicIpPrefix to BYOIP PublicIpPrefix. dany publiczny adres IP jest natychmiast przydzielany do tego zasobu z określonego publicznego prefiksuIpPrefix. Ta opcja jest obsługiwana tylko w przypadku jednostek SKU w warstwie Standardowa i alokacji statycznejMethod i publicIpPrefix byOIP.

Przykład 6. Tworzenie nowego globalnego publicznego adresu IP

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $domainNameLabel -Location $location -Sku Standard -Tier Global

To polecenie tworzy nowy globalny zasób publicznego adresu IP. Rekord DNS jest tworzony dla $dnsPrefix.$location.cloudapp.azure.com wskazujący publiczny adres IP tego zasobu. Globalny publiczny adres IP jest natychmiast przydzielany do tego zasobu. Ta opcja jest obsługiwana tylko w przypadku jednostek SKU w warstwie Standardowa i alokacji statycznejMethod.

Przykład 7. Tworzenie publicznego adresu IP przy użyciu elementu DomainNameLabelScope

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $location

To polecenie tworzy nowy zasób publicznego adresu IP. Przy użyciu parametru -DomainNameLabelScope platforma Azure tworzy rekord DNS z wartością skrótu w nazwie FQDN dla publicznego adresu IP przydzielonego do tego zasobu przy użyciu zasad sugerowanych przez $hasedReusePolicy.

Parametry

-AllocationMethod

Określa metodę przydzielania publicznego adresu IP. Dopuszczalne wartości tego parametru to: Statyczne lub Dynamiczne.

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:Dynamic, Static
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-AsJob

Uruchamianie polecenia cmdlet w tle

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DdosProtectionMode

DdosProtectionMode do użycia dla publicznego adresu IP

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:VirtualNetworkInherited, Enabled, Disabled
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-DdosProtectionPlanId

Identyfikator DdosProtectionPlan do dołączenia do publicznego adresu IP

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DomainNameLabel

Określa względną nazwę DNS dla publicznego adresu IP.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-DomainNameLabelScope

Określa wartość HashedReusePolicy dla nazwy DNS publicznego adresu IP.

Właściwości parametru

Typ:

Nullable<T>[PSDomainNameLabelScopeType]

Domyślna wartość:None
Dopuszczalne wartości:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-EdgeZone

Nazwa lokalizacji rozszerzonej.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-IdleTimeoutInMinutes

Określa limit czasu bezczynności w minutach.

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-IpAddress

Określa adres IP podczas tworzenia publicznego adresuIP BYOIPAddress.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-IpAddressVersion

Określa wersję adresu IP.

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:IPv4, IPv6
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-IpTag

Lista adresów IPTag.

Właściwości parametru

Typ:

PSPublicIpTag[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Location

Określa region, w którym ma zostać utworzony publiczny adres IP.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Name

Określa nazwę publicznego adresu IP tworzonego przez to polecenie cmdlet.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:NazwaZasobu

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-PublicIpPrefix

Określa psPublicIpPrefix, z którego ma być przydzielany publiczny adres IP.

Właściwości parametru

Typ:PSPublicIpPrefix
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ResourceGroupName

Określa nazwę grupy zasobów, w której ma zostać utworzony publiczny adres IP.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ReverseFqdn

Określa odwrotnie w pełni kwalifikowaną nazwę domeny (FQDN).

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Sku

Nazwa jednostki SKU publicznego adresu IP.

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:Basic, Standard, StandardV2
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Tag

Pary klucz-wartość w postaci tabeli skrótów. Na przykład: @{key0="value0"; key1=$null; key2="value2"}

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Tier

Warstwa jednostki SKU publicznego adresu IP.

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:Regional, Global
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Zone

Lista stref dostępności oznaczających adres IP przydzielony dla zasobu musi pochodzić.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

PSPublicIpTag

PSPublicIpPrefix

Int32

String

Hashtable

Dane wyjściowe

PSPublicIpAddress