Udostępnij za pośrednictwem


New-AzureRmPublicIpAddress

Tworzy publiczny adres IP.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Polecenie cmdlet New-AzureRmPublicIpAddress tworzy publiczny adres IP.

Przykłady

1: Tworzenie nowego publicznego adresu IP

$publicIp = New-AzureRmPublicIpAddress -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ż parametr -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).

2. Tworzenie publicznego adresu IP z odwrotną nazwą FQDN

$publicIp = New-AzureRmPublicIpAddress -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.

3. Tworzenie nowego publicznego adresu IP za pomocą elementu IpTag

$ipTag = New-AzureRmPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTags 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ż parametr -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. Element Iptag można określić przy użyciu polecenia New-AzureRmPublicIpTag i przekazać go jako dane wejściowe za pośrednictwem -IpTags.

4. Tworzenie nowego publicznego adresu IP na podstawie prefiksu

$publicIp = New-AzureRmPublicIpAddress -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.

Parametry

-AllocationMethod

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

Typ:String
Dopuszczalne wartości:Dynamic, Static
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-AsJob

Uruchamianie polecenia cmdlet w tle

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DomainNameLabel

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IdleTimeoutInMinutes

Określa limit czasu bezczynności w minutach.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-IpAddressVersion

Określa wersję adresu IP.

Typ:String
Dopuszczalne wartości:IPv4, IPv6
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-IpTag

Lista adresów IPTag.

Typ:List<T>[PSPublicIpTag]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Location

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

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

Typ:String
Aliasy:ResourceName
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PublicIpPrefix

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

Typ:PSPublicIpPrefix
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ReverseFqdn

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Sku

Nazwa jednostki SKU publicznego adresu IP.

Typ:String
Dopuszczalne wartości:Basic, Standard
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Tag

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

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Zone

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

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

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

Dane wyjściowe

PSPublicIpAddress