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

New-AzPublicIpAddress

Модуль:
Az.Network Module

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

Синтаксис

Default (по умолчанию) 

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 указан как статический. Если он указан как 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 указан как статический. Если он указан как 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
Default value:None
Допустимые значения:Dynamic, Static
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-AsJob

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DdosProtectionMode

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

Свойства параметра

Тип:String
Default value:None
Допустимые значения:VirtualNetworkInherited, Enabled, Disabled
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DdosProtectionPlanId

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DefaultProfile

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

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DomainNameLabel

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DomainNameLabelScope

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

Свойства параметра

Тип:

Nullable<T>[PSDomainNameLabelScopeType]

Default value:None
Допустимые значения:TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-EdgeZone

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Force

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IdleTimeoutInMinutes

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

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-IpAddress

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-IpAddressVersion

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

Свойства параметра

Тип:String
Default value:None
Допустимые значения:IPv4, IPv6
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-IpTag

Список IpTag.

Свойства параметра

Тип:

PSPublicIpTag[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Location

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Name

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ИмяРесурса

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-PublicIpPrefix

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

Свойства параметра

Тип:PSPublicIpPrefix
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ResourceGroupName

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ReverseFqdn

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Sku

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

Свойства параметра

Тип:String
Default value:None
Допустимые значения:Basic, Standard, StandardV2
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Tag

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

Свойства параметра

Тип:Hashtable
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Tier

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

Свойства параметра

Тип:String
Default value:None
Допустимые значения:Regional, Global
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Zone

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

String

PSPublicIpTag

PSPublicIpPrefix

Int32

String

Hashtable

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

PSPublicIpAddress