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 |
Входные данные
List<T>[[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]