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


New-AzPublicIpAddress

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

Синтаксис

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

Описание

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

Примеры

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

$publicIp = New-AzPublicIpAddress -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-AzPublicIpAddress -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-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $ipTag

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

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

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

Пример 5. Создание определенного общедоступного IP-адреса из префикса BYOIP

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

Эта команда создает новый ресурс общедоступного IP-адреса с определенным IP-адресом. NRP проверяет, находится ли указанный IP-адрес внутри PublicIpPrefix, и если данный publicIpPrefix имеет значение BYOIP PublicIpPrefix. указанный общедоступный IP-адрес немедленно выделяется этому ресурсу из указанного общедоступного ip-адреса. Этот параметр поддерживается только для SKU "Стандартный" и "Static" AllocationMethod и BYOIP PublicIpPrefix.

Пример 6. Создание нового глобального общедоступного IP-адреса

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

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

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

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

Эта команда создает новый ресурс общедоступного IP-адреса. С помощью параметра -DomainNameLabelScope Azure создает запись DNS с хэшируемым значением в FQDN для общедоступного IP-адреса, выделенного этому ресурсу, с политикой, предлагаемой $hasedReusePolicy.

Параметры

-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

-DdosProtectionMode

DdosProtectionMode, используемый для общедоступного IP-адреса

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

-DdosProtectionPlanId

Идентификатор DdosProtectionPlan для подключения к общедоступному IP-адресу

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

-DefaultProfile

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

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

-DomainNameLabel

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

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

-DomainNameLabelScope

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

Тип:Nullable<T>[PSDomainNameLabelScopeType]
Допустимые значения:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-EdgeZone

Имя расширенного расположения.

Тип: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

-IpAddress

Указывает IP-адрес при создании общедоступногоip byOIP PublicIpAddress.

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

-IpAddressVersion

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

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

-IpTag

Список IpTag.

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

-Location

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

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера: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

-Tier

Уровень SKU общедоступного IP-адреса.

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

-WhatIf

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

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

-Zone

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

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

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

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

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

PSPublicIpAddress