Поделиться через


New-AzureRmPublicIpAddress

Создает общедоступный IP-адрес.

Предупреждение

Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

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

Описание

Командлет New-AzureRmPublicIpAddress создает общедоступный IP-адрес.

Примеры

1. Создание нового общедоступного IP-адреса

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

Эта команда создает новый ресурс общедоступного IP-адреса. Запись DNS создается для $dnsPrefix.$location.cloudapp.azure.com, указывающей на общедоступный IP-адрес этого ресурса. Общедоступный IP-адрес сразу же выделяется этому ресурсу, так как параметр -AllocationMethod указывается как static. Если он указан как Dynamic, общедоступный IP-адрес выделяется только при запуске (или создании) связанного ресурса (например, виртуальной машины или подсистемы балансировки нагрузки).

2. Создание общедоступного IP-адреса с обратным полным доменным именем

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

Эта команда создает новый ресурс общедоступного IP-адреса. С помощью параметра -ReverseFqdn Azure создает запись DNS PTR (обратный поиск) для общедоступного IP-адреса, выделенного этому ресурсу, указывая на $customFqdn, указанные в команде. В качестве предварительных требований $customFqdn (скажем, webapp.contoso.com) должен иметь запись DNS CNAME (вперед-поиск), указывающую на $dnsPrefix.$location.cloudapp.azure.com.

3. Создание общедоступного IP-адреса с помощью IpTag

$ipTag = New-AzureRmPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTags ipTag

Эта команда создает новый ресурс общедоступного IP-адреса. Запись DNS создается для $dnsPrefix.$location.cloudapp.azure.com, указывающей на общедоступный IP-адрес этого ресурса. Общедоступный IP-адрес сразу же выделяется этому ресурсу, так как параметр -AllocationMethod указывается как static. Если он указан как Dynamic, общедоступный IP-адрес выделяется только при запуске (или создании) связанного ресурса (например, виртуальной машины или подсистемы балансировки нагрузки). Iptag используется для конкретных тегов, связанных с ресурсом. Iptag можно указать с помощью New-AzureRmPublicIpTag и передать в качестве входных данных через -IpTags.

4. Создание нового общедоступного IP-адреса из префикса

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

Эта команда создает новый ресурс общедоступного IP-адреса. Запись DNS создается для $dnsPrefix.$location.cloudapp.azure.com, указывающей на общедоступный IP-адрес этого ресурса. Общедоступный IP-адрес немедленно выделяется этому ресурсу из указанного publicIpPrefix. Этот параметр поддерживается только для Sku уровня "Стандартный" и "Static" AllocationMethod.

Параметры

-AllocationMethod

Задает метод, с помощью которого выделяется общедоступный IP-адрес. Допустимыми значениями этого параметра являются статические или динамические.

Тип:String
Допустимые значения:Dynamic, Static
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-AsJob

Запуск командлета в фоновом режиме

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Тип:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DomainNameLabel

Указывает относительное DNS-имя для общедоступного IP-адреса.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Force

Принудительное выполнение команды без запроса на подтверждение пользователем.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IdleTimeoutInMinutes

Указывает время ожидания простоя в минутах.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-IpAddressVersion

Указывает версию IP-адреса.

Тип:String
Допустимые значения:IPv4, IPv6
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-IpTag

Список IpTag.

Тип:List<T>[PSPublicIpTag]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Location

Указывает регион, в котором создается общедоступный IP-адрес.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Указывает имя общедоступного IP-адреса, создаваемого этим командлетом.

Тип:String
Aliases:ResourceName
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PublicIpPrefix

Указывает PSPublicIpPrefix, из которого следует выделить общедоступный IP-адрес.

Тип:PSPublicIpPrefix
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ResourceGroupName

Указывает имя группы ресурсов, в которой создается общедоступный IP-адрес.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ReverseFqdn

Указывает обратное полное доменное имя (FQDN).

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Sku

Имя SKU общедоступного IP-адреса.

Тип:String
Допустимые значения:Basic, Standard
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Tag

Пары "ключ-значение" в виде хэш-таблицы. Например: @{key0="value0"; key1=$null; key2="value2"}

Тип:Hashtable
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Zone

Список зон доступности, обозначающих IP-адрес, выделенный для ресурса, должен поступать из.

Тип:List<T>[String]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

Входные данные

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

Выходные данные

PSPublicIpAddress