New-AzPublicIpAddress

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.

Type:String
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-AsJob

Uruchamianie polecenia cmdlet w tle

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DdosProtectionMode

DdosProtectionMode do użycia dla publicznego adresu IP

Type:String
Accepted values:VirtualNetworkInherited, Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DdosProtectionPlanId

Identyfikator DdosProtectionPlan do dołączenia do publicznego adresu IP

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainNameLabel

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DomainNameLabelScope

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

Type:Nullable<T>[PSDomainNameLabelScopeType]
Accepted values:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EdgeZone

Nazwa lokalizacji rozszerzonej.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdleTimeoutInMinutes

Określa limit czasu bezczynności w minutach.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IpAddress

Określa adres IP podczas tworzenia publicznego adresuIP BYOIPAddress.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IpAddressVersion

Określa wersję adresu IP.

Type:String
Accepted values:IPv4, IPv6
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IpTag

Lista adresów IPTag.

Type:PSPublicIpTag[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Aliases:ResourceName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicIpPrefix

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

Type:PSPublicIpPrefix
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReverseFqdn

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Sku

Nazwa jednostki SKU publicznego adresu IP.

Type:String
Accepted values:Basic, Standard
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

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

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tier

Warstwa jednostki SKU publicznego adresu IP.

Type:String
Accepted values:Regional, Global
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

Dane wyjściowe

PSPublicIpAddress