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


Add-AzureEndpoint

Добавляет конечную точку в виртуальную машину.

Примечание.

Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.

Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.

Синтаксис

Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   [-NoProbe]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   [-DefaultProbe]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   -ProbePort <Int32>
   -ProbeProtocol <String>
   [-ProbePath <String>]
   [-ProbeIntervalInSeconds <Int32>]
   [-ProbeTimeoutInSeconds <Int32>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Описание

Командлет Add-AzureEndpoint добавляет конечную точку в объект виртуальной машины Azure.

Примеры

Пример 1. Добавление конечной точки

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 | Update-AzureVM

Эта команда извлекает конфигурацию виртуальной машины с именем VirtualMachine01 с помощью командлета Get-AzureVM . Команда передает его текущему командлету с помощью оператора конвейера. Этот командлет добавляет конечную точку с именем HttpIn. Конечная точка имеет общедоступный порт 80 и локальный порт 8080. Команда передает объект виртуальной машины командлету Update-AzureVM , который реализует изменения.

Пример 2. Добавление конечной точки, принадлежащую группе балансировки нагрузки

PS C:\> Get-AzureVM -ServiceName "LoadBalancedService" -Name "VirtualMachine12" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 -LBSetName "WebFarm" -ProbePort 80 -ProbeProtocol "http" -ProbePath '/' | Update-AzureVM

Эта команда извлекает конфигурацию виртуальной машины с именем VirtualMachine07. Текущий командлет добавляет конечную точку с именем HttpIn. Конечная точка имеет общедоступный порт 80 и локальный порт 8080. Конечная точка принадлежит группе с балансировкой нагрузки с именем WebFarm. Проба HTTP через порт 80 с путем "/" отслеживает доступность конечной точки. Команда реализует изменения.

Пример 3. Связывание виртуального IP-адреса с конечной точкой

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine25" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -LocalPort 8080 -PublicPort 80 -VirtualIPName "ContosoVip11" | Update-AzureVM

Эта команда извлекает конфигурацию виртуальной машины с именем VirtualMachine25. Текущий командлет добавляет конечную точку с именем HttpIn. Конечная точка имеет общедоступный порт 80 и локальный порт 8080. Эта команда связывает виртуальный IP-адрес с конечной точкой. Команда реализует изменения.

Параметры

-ACL

Указывает объект конфигурации списка управления доступом (ACL) для конечной точки.

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

-DefaultProbe

Указывает, что этот командлет использует параметр пробы по умолчанию.

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

-DirectServerReturn

Указывает, включает ли этот командлет прямой возврат сервера. Укажите $True, чтобы включить или $False отключить.

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

-IdleTimeoutInMinutes

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

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

-InternalLoadBalancerName

Задает имя внутренней подсистемы балансировки нагрузки.

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

-LBSetName

Указывает имя набора подсистемы балансировки нагрузки для конечной точки.

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

-LoadBalancerDistribution

Задает алгоритм распределения подсистемы балансировки нагрузки. Допустимые значения:

  • sourceIP. Сопоставление двух кортежей: исходный IP-адрес, IP-адрес назначения
  • sourceIPProtocol. Сопоставление трех кортежей: исходный IP-адрес, конечный IP-адрес, протокол
  • никакой. Пять сопоставлений кортежей: исходный IP-адрес, исходный порт, ip-адрес назначения, порт назначения, протокол

Значение по умолчанию — нет.

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

-LocalPort

Указывает локальный, частный порт, используемый этой конечной точкой. Приложения в виртуальной машине прослушивают этот порт для запросов на входные данные службы для этой конечной точки.

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

-Name

Указывает имя конечной точки.

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

-NoProbe

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

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

-ProbeIntervalInSeconds

Указывает интервал опроса пробы в секундах для конечной точки.

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

-ProbePath

Указывает относительный путь к пробе HTTP.

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

-ProbePort

Указывает порт, используемый конечной точкой.

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

-ProbeProtocol

Указывает протокол порта. Допустимые значения:

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

-ProbeTimeoutInSeconds

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

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

-Profile

Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.

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

-Protocol

Указывает протокол конечной точки. Допустимые значения:

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

-PublicPort

Указывает общедоступный порт, используемый конечной точкой. Если значение не указано, Azure назначает доступный порт.

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

-VirtualIPName

Указывает имя виртуального IP-адреса, который Azure связывает с конечной точкой. Служба может иметь несколько виртуальных IP-адресов. Чтобы создать виртуальные IP-адреса, используйте командлет Add-AzureVirtualIP .

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

-VM

Указывает виртуальную машину, к которой принадлежит конечная точка.

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

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

Object