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[]
Выходные данные
Связанные ссылки
Azure PowerShell