New-AzNetworkCloudKubernetesCluster

Модуль:

Az.NetworkCloud

Создайте новый кластер Kubernetes или обновите свойства существующего.

Синтаксис

New-AzNetworkCloudKubernetesCluster
   -KubernetesClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -ControlPlaneNodeConfigurationCount <Int64>
   -ControlPlaneNodeConfigurationVMSkuName <String>
   -ExtendedLocationName <String>
   -ExtendedLocationType <String>
   -InitialAgentPoolConfiguration <IInitialAgentPoolConfiguration[]>
   -KubernetesVersion <String>
   -Location <String>
   -NetworkConfigurationCloudServicesNetworkId <String>
   -NetworkConfigurationCniNetworkId <String>
   [-AadConfigurationAdminGroupObjectId <String[]>]
   [-AdminUsername <String>]
   [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
   [-BgpAdvertisement <IBgpAdvertisement[]>]
   [-BgpIPAddressPool <IIPAddressPool[]>]
   [-BgpPeer <IServiceLoadBalancerBgpPeer[]>]
   [-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled <FabricPeeringEnabled>]
   [-ControlPlaneNodeConfigurationAdminPublicKey <ISshPublicKey[]>]
   [-ControlPlaneNodeConfigurationAdminUsername <String>]
   [-ControlPlaneNodeConfigurationAvailabilityZone <String[]>]
   [-L2ServiceLoadBalancerConfigurationIPAddressPool <IIPAddressPool[]>]
   [-ManagedResourceGroupConfigurationLocation <String>]
   [-ManagedResourceGroupConfigurationName <String>]
   [-NetworkConfigurationDnsServiceIP <String>]
   [-NetworkConfigurationPodCidr <String[]>]
   [-NetworkConfigurationServiceCidr <String[]>]
   [-SshPublicKey <ISshPublicKey[]>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Создайте новый кластер Kubernetes или обновите свойства существующего.

Примеры

Пример 1. Создание кластера Kubernetes

$tagHash = @{tags = "tag1" }
$agentPoolConfiguration = @{
    count = 1
    mode = "System"
    name = "agentPoolName"
    vmSkuName = "vmSkuName"
    administratorConfiguration = "administratorConfiguration"
}
$sshPublicKey = @{
    KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
}
New-AzNetworkCloudKubernetesCluster -ResourceGroupName resourceGroupName `
                -KubernetesClusterName default -Location location `
                -ExtendedLocationName extendedLocationName `
                -ExtendedLocationType "CustomLocation" `
                -KubernetesVersion kubernetesVersion `
                -AadConfigurationAdminGroupObjectId adminGroupObjectIds `
                -AdminUsername "azureuser" `
                -SshPublicKey $sshPublicKey `
                -InitialAgentPoolConfiguration $agentPoolConfiguration `
                -NetworkConfigurationCloudServicesNetworkId cloudServicesNetworkId `
                -NetworkConfigurationCniNetworkId cniNetworkId `
                -SubscriptionId subscriptionId `
                -Tag $tagHash

Location Name    SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy             SystemDataLastModifiedByType ResourceGroupName
-------- ----    ------------------- -------------------    ----------------------- ------------------------ ------------------------             ---------------------------- -----------------
eastus   default 08/09/2023 20:23:17 <identity>             User                    08/09/2023 20:44:27      <identity>                            Application                 resourceGroupName

Эта команда создает кластер Kubernetes.

Параметры

-AadConfigurationAdminGroupObjectId

Список идентификаторов объектов группы Azure Active Directory, которые будут иметь административную роль в кластере Kubernetes.

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

-AdminUsername

Имя пользователя администратора, которое будет применено к операционным системам, на которые выполняются узлы Kubernetes. Если он не указан, имя пользователя будет выбрано службой.

Тип:	String
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

-BgpAdvertisement

Связь пулов IP-адресов с сообществами и одноранговыми узлами, что позволяет объявлять IP-адреса. Сведения о создании см. в разделе NOTES для свойств BGPADVERTISEMENT и создания хэш-таблицы.

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

-BgpIPAddressPool

Список пулов IP-адресов, которые могут быть выделены службам подсистемы балансировки нагрузки. Сведения о создании см. в разделе NOTES для свойств BGPIPADDRESSPOOL и создания хэш-таблицы.

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

-BgpPeer

Список дополнительных сущностей BgpPeer, с которым будет одноранговым кластером Kubernetes. Все пиринги должны быть явно определены. Сведения о создании см. в разделе NOTES для свойств BGPPEER и создании хэш-таблицы.

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

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

Индикатор, указывающий, если одноранговые узлы подсистемы балансировки нагрузки с сетевой структурой.

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

-Confirm

Запрашивает подтверждение перед запуском командлета.

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

-ControlPlaneNodeConfigurationAdminPublicKey

Конфигурация SSH для операционных систем, запускающих узлы в кластере Kubernetes. В некоторых случаях для создания рабочей среды может потребоваться спецификация открытых ключей. Сведения о создании см. в разделе NOTES для свойств CONTROLPLANENODECONFIGURATIONADMINPUBLICKEY и создания хэш-таблицы.

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

-ControlPlaneNodeConfigurationAdminUsername

Имя пользователя администратора, которое будет применено к операционным системам, на которые выполняются узлы Kubernetes. Если он не указан, имя пользователя будет выбрано службой.

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

-ControlPlaneNodeConfigurationAvailabilityZone

Список зон доступности кластера Network Cloud, используемый для подготовки узлов в плоскости управления. Если не указано, будут использоваться все зоны доступности.

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

-ControlPlaneNodeConfigurationCount

Количество виртуальных машин, использующих эту конфигурацию.

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

-ControlPlaneNodeConfigurationVMSkuName

Имя номера SKU виртуальной машины, предоставленного во время создания.

Тип:	String
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
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ExtendedLocationType

Тип расширенного расположения, например CustomLocation.

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

-InitialAgentPoolConfiguration

Пулы агентов, созданные с помощью этого кластера Kubernetes для выполнения критически важных системных служб и рабочих нагрузок. Эти данные в этом поле используются только во время создания, и поле будет пустым после создания кластера Kubernetes. После создания управление пулами агентов выполняется с помощью подресурса agentPools. Сведения о создании см. в разделе NOTES для свойств INITIALAGENTPOOLCONFIGURATION и создания хэш-таблицы.

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

-KubernetesClusterName

Имя кластера Kubernetes.

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

-KubernetesVersion

Версия Kubernetes для этого кластера.

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

-L2ServiceLoadBalancerConfigurationIPAddressPool

Список пулов IP-адресов, которые могут быть выделены службам подсистемы балансировки нагрузки. Сведения о создании см. в разделе NOTES о свойствах L2SERVICELOADBALANCERCONFIGURATIONIPADDRESSPOOL и создании хэш-таблицы.

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

-Location

Географическое расположение, в котором находится ресурс

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

-ManagedResourceGroupConfigurationLocation

Расположение управляемой группы ресурсов. Если это не указано, выбирается расположение родительского ресурса.

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

-ManagedResourceGroupConfigurationName

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

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

-NetworkConfigurationCloudServicesNetworkId

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

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

-NetworkConfigurationCniNetworkId

Идентификатор ресурса сети уровня 3, используемой для создания сети сетевого интерфейса контейнера.

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

-NetworkConfigurationDnsServiceIP

IP-адрес, назначенный службе DNS Kubernetes. Он должен находиться в диапазоне адресов службы Kubernetes, указанных в CIDR службы.

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

-NetworkConfigurationPodCidr

Диапазоны IP-адресов нотации CIDR, из которых следует назначать IP-адреса pod. Ожидается, что для сети с одним стеком ожидается одноуровневая сеть IPv4 CIDR. Ожидается, что для каждой семейства IP-адресов (IPv4/IPv6) ожидается два CIDR.

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

-NetworkConfigurationServiceCidr

Диапазоны IP-адресов нотации CIDR, из которых следует назначать IP-адреса служб. Ожидается, что для сети с одним стеком ожидается одноуровневая сеть IPv4 CIDR. Ожидается, что для каждой семейства IP-адресов (IPv4/IPv6) ожидается два CIDR.

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

-NoWait

Асинхронное выполнение команды

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

-ResourceGroupName

Имя группы ресурсов. Имя не учитывает регистр.

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

-SshPublicKey

Конфигурация SSH для операционных систем, запускающих узлы в кластере Kubernetes. В некоторых случаях для создания рабочей среды может потребоваться спецификация открытых ключей. Сведения о создании см. в разделе NOTES для свойств SSHPUBLICKEY и создания хэш-таблицы.

Тип:	ISshPublicKey[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	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

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

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

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

IKubernetesCluster