New-AzNetworkCloudAgentPool
Создайте новый пул агентов кластера Kubernetes или обновите свойства существующего.
Синтаксис
New-AzNetworkCloudAgentPool
-KubernetesClusterName <String>
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-Count <Int64>
-Location <String>
-Mode <AgentPoolMode>
-VMSkuName <String>
[-AdministratorConfigurationAdminUsername <String>]
[-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
[-AgentOptionHugepagesCount <Int64>]
[-AgentOptionHugepagesSize <HugepagesSize>]
[-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
[-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
[-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
[-AvailabilityZone <String[]>]
[-ExtendedLocationName <String>]
[-ExtendedLocationType <String>]
[-Label <IKubernetesLabel[]>]
[-Tag <Hashtable>]
[-Taint <IKubernetesLabel[]>]
[-UpgradeSettingDrainTimeout <Int64>]
[-UpgradeSettingMaxSurge <String>]
[-UpgradeSettingMaxUnavailable <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Описание
Создайте новый пул агентов кластера Kubernetes или обновите свойства существующего.
Примеры
Пример 1. Создание пула агентов кластера Kubernetes
$networkAttachment = @{
AttachedNetworkId = "l3NetworkId"
}
$labels = @{
Key = "key"
Value = "value"
}
$taints = @{
Key = "key"
Value = "value"
}
$sshPublicKey = @{
KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
}
New-AzNetworkCloudAgentPool -KubernetesClusterName clusterName -Name agentPoolName -ResourceGroupName resourceGroup -Count count -Location location -Mode agentPoolMode -VMSkuName vmSkuName -SubscriptionId subscriptionId -AdministratorConfigurationAdminUsername adminUsername -AdministratorConfigurationSshPublicKey $sshPublicKey -AgentOptionHugepagesCount hugepagesCount -AgentOptionHugepagesSize hugepagesSize -AttachedNetworkConfigurationL3Network $networkAttachment -AvailabilityZone availabilityZones -ExtendedLocationName clusterExtendedLocation -ExtendedLocationType "CustomLocation " -Tag @{tags = "tag"} -Label $labels -Taint $taints -UpgradeSettingMaxSurge maxSurge
Location Name SystemDataCreatedAt SystemDataCreatedBy SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy
-------- ---- ------------------- ------------------- ----------------------- ------------------------ ------------
westus3 agentpool1 07/18/2023 17:44:02 <identity> User 07/18/2023 17:46:45 <identity>Эта команда создает пул агентов для данного кластера Kubernetes.
Параметры
-AdministratorConfigurationAdminUsername
Имя пользователя администратора, которое будет применено к операционным системам, на которые выполняются узлы Kubernetes. Если он не указан, имя пользователя будет выбрано службой.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AdministratorConfigurationSshPublicKey
Конфигурация SSH для операционных систем, запускающих узлы в кластере Kubernetes. В некоторых случаях для создания рабочей среды может потребоваться спецификация открытых ключей. Сведения о создании см. в разделе NOTES для свойств ADMINISTRATORCONFIGURATIONSSHPUBLICKEY и создания хэш-таблицы.
| Тип: | ISshPublicKey[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AgentOptionHugepagesCount
Количество огромных страниц для выделения.
| Тип: | Int64 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AgentOptionHugepagesSize
Размер огромных страниц для выделения.
| Тип: | HugepagesSize |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AsJob
Выполнение команды в качестве задания
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AttachedNetworkConfigurationL2Network
Список сетей уровня 2 и связанная конфигурация для вложения. Сведения о создании см. в разделе NOTES для ATTACHEDNETWORKCONFIGURATIONL2NETWORK свойств и создания хэш-таблицы.
| Тип: | IL2NetworkAttachmentConfiguration[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AttachedNetworkConfigurationL3Network
Список сетей уровня 3 и связанной конфигурации для вложения. Сведения о создании см. в разделе NOTES для свойств ATTACHEDNETWORKCONFIGURATIONL3NETWORK и создания хэш-таблицы.
| Тип: | IL3NetworkAttachmentConfiguration[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AttachedNetworkConfigurationTrunkedNetwork
Список магистральных сетей и связанной конфигурации для вложения. Сведения о создании см. в разделе NOTES для свойств ATTACHEDNETWORKCONFIGURATIONTRUNKEDNETWORK и создания хэш-таблицы.
| Тип: | ITrunkedNetworkAttachmentConfiguration[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AvailabilityZone
Список зон доступности кластера Network Cloud, используемый для подготовки узлов в этом пуле агентов. Если не указано, будут использоваться все зоны доступности.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Count
Количество виртуальных машин, использующих эту конфигурацию.
| Тип: | Int64 |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DefaultProfile
Параметр DefaultProfile не работает. Используйте параметр SubscriptionId, если он доступен при выполнении командлета в другой подписке.
| Тип: | PSObject |
| Aliases: | AzureRMContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ExtendedLocationName
Идентификатор ресурса расширенного расположения, в котором будет создан ресурс.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ExtendedLocationType
Тип расширенного расположения, например CustomLocation.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-KubernetesClusterName
Имя кластера Kubernetes.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Label
Метки, примененные к узлам в этом пуле агентов. Сведения о создании см. в разделе NOTES для свойств LABEL и создании хэш-таблицы.
| Тип: | IKubernetesLabel[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Location
Географическое расположение, в котором находится ресурс
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Mode
Выбор способа использования этого пула агентов в качестве системного пула или пула пользователей. Системные пулы выполняют функции и критически важные службы для кластера Kubernetes, а пулы пользователей предназначены для рабочих нагрузок пользователей. Каждый кластер Kubernetes должен содержать по крайней мере один системный пул узлов по крайней мере с одним узлом.
| Тип: | AgentPoolMode |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Name
Имя пула агентов кластера Kubernetes.
| Тип: | String |
| Aliases: | AgentPoolName |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-NoWait
Асинхронное выполнение команды
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ResourceGroupName
Имя группы ресурсов. Имя не учитывает регистр.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-SubscriptionId
Идентификатор целевой подписки. Значение должно быть UUID.
| Тип: | String |
| Position: | Named |
| Default value: | (Get-AzContext).Subscription.Id |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Tag
Теги ресурсов.
| Тип: | Hashtable |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Taint
Фрагменты, примененные к узлам в этом пуле агентов. Сведения о создании см. в разделе NOTES для свойств TAINT и создании хэш-таблицы.
| Тип: | IKubernetesLabel[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-UpgradeSettingDrainTimeout
Максимальное время в секундах, которое разрешено для завершения очистки узлов, прежде чем продолжить обновление пула агентов. Если не указано во время создания, используется значение 1800 секунд.
| Тип: | Int64 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-UpgradeSettingMaxSurge
Максимальное число или процент узлов, которые резко возросли во время обновления. Для этого можно задать целое число (например, "5") или процент (например, "50%". Если указан процент, это процент общего размера пула агентов во время обновления. В процентах дробные узлы округляются вверх. Если не указано во время создания, используется значение 1. Один из MaxSurge и MaxUnavailable должен быть больше 0.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-UpgradeSettingMaxUnavailable
Максимальное число узлов или процент узлов, которые могут быть недоступны во время обновления. Для этого можно задать целое число (например, "5") или процент (например, "50%". Если указан процент, это процент общего размера пула агентов во время обновления. В процентах дробные узлы округляются вверх. Если значение не указано во время создания, используется значение 0. Один из MaxSurge и MaxUnavailable должен быть больше 0.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-VMSkuName
Имя SKU виртуальной машины, определяющего размер ресурсов, выделенных для виртуальных машин узла.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |