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 |