Udostępnij za pośrednictwem

New-AzPublicIpAddress

  • Odwołanie
Moduł:
Az.Network

Tworzy publiczny adres IP.

Składnia

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ż 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).

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ż 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. Adres IPtag można określić przy użyciu polecenia New-AzPublicIpTag i przekazać go 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. Za pomocą 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.

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

-DdosProtectionMode

DdosProtectionMode do użycia dla publicznego adresu IP

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

-DdosProtectionPlanId

Identyfikator DdosProtectionPlan do dołączenia do publicznego adresu IP

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

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzContext, 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

-DomainNameLabelScope

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

Typ:Nullable<T>[PSDomainNameLabelScopeType]
Dopuszczalne wartości:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-EdgeZone

Nazwa lokalizacji rozszerzonej.

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

-IpAddress

Określa adres IP podczas tworzenia publicznego adresuIP BYOIPAddress.

Typ:String
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: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:True
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

-Tier

Warstwa jednostki SKU publicznego adresu IP.

Typ:String
Dopuszczalne wartości:Regional, Global
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:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Dane wyjściowe

PSPublicIpAddress