Set-AzurePublicIP
Добавляет общедоступный IP-адрес в виртуальную машину Azure.
Примечание.
Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.
Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.
Синтаксис
Set-AzurePublicIP
[-PublicIPName] <String>
[[-IdleTimeoutInMinutes] <Int32>]
[[-DomainNameLabel] <String>]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Описание
Командлет Set-AzurePublicIP добавляет общедоступный IP-адрес в виртуальную машину Azure. При запуске этого командлета для существующей виртуальной машины обновите виртуальную машину, чтобы реализовать изменения. Вы можете указать метку доменного имени, чтобы создать соответствующую запись DNS для общедоступного IP-адреса.
Примеры
Пример 1. Добавление общедоступного IP-адреса в существующую виртуальную машину
PS C:\> Get-AzureVM -ServiceName "FTPInAzure" -Name "FTPInstance" | Set-AzurePublicIP -PublicIPName "ftpip" | Update-AzureVM
Эта команда получает виртуальную машину с именем FTPInstance в службе с именем FTPInAzure с помощью командлета Get-AzureVM . Команда передает эту виртуальную машину текущему командлету с помощью оператора конвейера. Текущий командлет добавляет ftpip имени общедоступного IP-адреса. Команда передает виртуальную машину командлету Update-AzureVM , который реализует изменения.
Пример 2. Добавление общедоступного IP-адреса в новую виртуальную машину
PS C:\> New-AzureVMConfig -Name "FTPInstance" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -AdminUsername "AdminMain" -Password "password" | Set-AzurePublicIP -PublicIPName "ftpip" | New-AzureVM -ServiceName "FTPinAzure" -Location "North Central US"
Эта команда создает объект конфигурации виртуальной машины с помощью командлета New-AzureVMConfig . Команда передает этот объект командлету Add-AzureProvisioningConfig , который предоставляет дополнительную конфигурацию. Текущий командлет добавляет ftpip имени общедоступного IP-адреса. Команда передает конфигурацию командлету New-AzureVM , который создает виртуальную машину.
Пример 3. Добавление общедоступного IP-адреса и метки в существующую виртуальную машину
PS C:\> Get-AzureVM -ServiceName "FTPInAzure" -Name "FTPInstance" | Set-AzurePublicIP -PublicIPName "ftpip" -DomainNameLabel "ipname" | Update-AzureVM
Эта команда получает виртуальную машину с именем FTPInstance в службе с именем FTPInAzure с помощью командлета Get-AzureVM . Команда передает эту виртуальную машину текущему командлету с помощью оператора конвейера. Текущий командлет добавляет ftpip имени общедоступного IP-адреса и ipname метки. Команда обновляет виртуальную машину, которая реализует изменения.
Пример 4. Добавление общедоступного IP-адреса и метки в новую виртуальную машину
PS C:\> New-AzureVMConfig -Name "FTPInstance" -InstanceSize Small -ImageName $images[50].ImageName | Add-AzureProvisioningConfig -Windows -AdminUsername "AdminMain" -Password "password" | Set-AzurePublicIP -PublicIPName "ftpip" -DomainNameLabel "ipname" | New-AzureVM -ServiceName "FTPinAzure" -Location "North Central US"
Эта команда создает объект конфигурации виртуальной машины, а затем передает этот объект в Add-AzureProvisioningConfig, который предоставляет дополнительную конфигурацию. Текущий командлет добавляет ftpip имени общедоступного IP-адреса и ipname метки. Команда создает виртуальную машину.
Параметры
-DomainNameLabel
Указывает имя, используемое для соответствующей записи DNS для общедоступного IP-адреса.
Тип: | String |
Position: | 3 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-IdleTimeoutInMinutes
Указывает период времени ожидания простоя TCP в минутах.
Тип: | Int32 |
Position: | 2 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InformationAction
Указывает, как этот командлет реагирует на событие сведений.
Допустимые значения для этого параметра:
- Продолжить
- Пропустить
- Спрашивать
- SilentlyContinue
- Остановить
- Приостановить
Тип: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InformationVariable
Указывает переменную сведений.
Тип: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Profile
Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.
Тип: | AzureSMProfile |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-PublicIPName
Указывает общедоступное IP-имя.
Тип: | String |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-VM
Указывает виртуальную машину, к которой этот командлет добавляет общедоступный IP-адрес.
Тип: | IPersistentVM |
Aliases: | InputObject |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Выходные данные
Microsoft.WindowsAzure.Commands.ServiceManagement.Model.IPersistentVM