Compartir a través de

New-AzNetworkCloudKubernetesCluster

  • Referencia
Módulo:
Az.NetworkCloud

Cree un nuevo clúster de Kubernetes o actualice las propiedades de la existente.

Sintaxis

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[]>]
   [-ManagedResourceGroupConfigurationLocation <String>]
   [-ManagedResourceGroupConfigurationName <String>]
   [-NetworkConfigurationDnsServiceIP <String>]
   [-NetworkConfigurationPodCidr <String[]>]
   [-NetworkConfigurationServiceCidr <String[]>]
   [-SshPublicKey <ISshPublicKey[]>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cree un nuevo clúster de Kubernetes o actualice las propiedades de la existente.

Ejemplos

Ejemplo 1: Creación de un clúster de 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

Este comando crea un clúster de Kubernetes.

Parámetros

-AadConfigurationAdminGroupObjectId

Lista de identificadores de objeto de grupo de Azure Active Directory que tendrán un rol administrativo en el clúster de Kubernetes.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AdminUsername

Nombre de usuario del administrador que se aplicará a los sistemas operativos que ejecutan nodos de Kubernetes. Si no se proporciona, el servicio elegirá un nombre de usuario.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AsJob

Ejecución del comando como trabajo

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AttachedNetworkConfigurationL2Network

Lista de redes de nivel 2 y configuración relacionada para los datos adjuntos. Para construir, consulte la sección NOTES para obtener ATTACHEDNETWORKCONFIGURATIONL2NETWORK propiedades y crear una tabla hash.

Tipo:IL2NetworkAttachmentConfiguration[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AttachedNetworkConfigurationL3Network

Lista de redes de nivel 3 y configuración relacionada para datos adjuntos. Para construir, consulte la sección NOTES para obtener ATTACHEDNETWORKCONFIGURATIONL3NETWORK propiedades y crear una tabla hash.

Tipo:IL3NetworkAttachmentConfiguration[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AttachedNetworkConfigurationTrunkedNetwork

La lista de redes troncales y la configuración relacionada para los datos adjuntos. Para construir, consulte la sección NOTES de las propiedades ATTACHEDNETWORKCONFIGURATIONTRUNKEDNETWORK y cree una tabla hash.

Tipo:ITrunkedNetworkAttachmentConfiguration[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BgpAdvertisement

Asociación de grupos de direcciones IP a las comunidades y compañeros, lo que permite el anuncio de direcciones IP. Para construir, consulte la sección NOTES de las propiedades BGPADVERTISEMENT y cree una tabla hash.

Tipo:IBgpAdvertisement[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BgpIPAddressPool

Lista de grupos de direcciones IP que se pueden asignar a los servicios de Load Balancer. Para construir, consulte la sección NOTES de las propiedades BGPIPADDRESSPOOL y cree una tabla hash.

Tipo:IIPAddressPool[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BgpPeer

Lista de entidades BgpPeer adicionales con las que se emparejará el clúster de Kubernetes. Todo el emparejamiento debe definirse explícitamente. Para construir, consulte la sección NOTES de las propiedades BGPPEER y cree una tabla hash.

Tipo:IServiceLoadBalancerBgpPeer[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

Indicador que se especifica si el equilibrador de carga empareja con el tejido de red.

Tipo:FabricPeeringEnabled
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ControlPlaneNodeConfigurationAdminPublicKey

Configuración de SSH para los sistemas operativos que ejecutan los nodos en el clúster de Kubernetes. En algunos casos, es posible que se requiera la especificación de claves públicas para generar un entorno de trabajo. Para construir, consulte la sección NOTES de las propiedades CONTROLPLANENODECONFIGURATIONADMINPUBLICKEY y cree una tabla hash.

Tipo:ISshPublicKey[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ControlPlaneNodeConfigurationAdminUsername

Nombre de usuario del administrador que se aplicará a los sistemas operativos que ejecutan nodos de Kubernetes. Si no se proporciona, el servicio elegirá un nombre de usuario.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ControlPlaneNodeConfigurationAvailabilityZone

Lista de zonas de disponibilidad del clúster de nube de red que se va a usar para el aprovisionamiento de nodos en el plano de control. Si no se especifica, se usarán todas las zonas de disponibilidad.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ControlPlaneNodeConfigurationCount

Número de máquinas virtuales que usan esta configuración.

Tipo:Int64
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ControlPlaneNodeConfigurationVMSkuName

Nombre de la SKU de máquina virtual proporcionada durante la creación.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

Tipo:PSObject
Alias:AzureRMContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExtendedLocationName

Identificador de recurso de la ubicación extendida en la que se creará el recurso.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExtendedLocationType

El tipo de ubicación extendida, por ejemplo, CustomLocation.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InitialAgentPoolConfiguration

Los grupos de agentes que se crean con este clúster de Kubernetes para ejecutar cargas de trabajo y servicios del sistema críticos. Estos datos de este campo solo se usan durante la creación y el campo estará vacío después de la creación del clúster de Kubernetes. Después de la creación, la administración de grupos de agentes se realiza mediante el subrecurso agentPools. Para construir, consulte la sección NOTES de las propiedades INITIALAGENTPOOLCONFIGURATION y cree una tabla hash.

Tipo:IInitialAgentPoolConfiguration[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-KubernetesClusterName

Nombre del clúster de Kubernetes.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-KubernetesVersion

Versión de Kubernetes para este clúster. Acepta el formato n.n, n.n.n y n.n-n. La versión interpretada usada se resolverá en este campo después de la creación o actualización.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Location

Ubicación geográfica donde reside el recurso

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ManagedResourceGroupConfigurationLocation

Ubicación del grupo de recursos administrado. Si no se especifica, se elige la ubicación del recurso primario.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ManagedResourceGroupConfigurationName

Nombre del grupo de recursos administrado. Si no se especifica, se genera automáticamente el nombre único.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NetworkConfigurationCloudServicesNetworkId

Identificador de recurso de la red de Cloud Services asociada.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NetworkConfigurationCniNetworkId

Identificador de recurso de la red de nivel 3 que se usa para la creación de la red de interfaz de red de contenedor.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NetworkConfigurationDnsServiceIP

La dirección IP asignada al servicio DNS de Kubernetes. Debe estar dentro del intervalo de direcciones del servicio kubernetes especificado en el CIDR del servicio.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NetworkConfigurationPodCidr

Intervalos IP de notación CIDR desde los que se van a asignar direcciones IP de pod. Se espera un CIDR IPv4 para las redes de una sola pila. Se esperan dos CIDR, uno para cada familia IP (IPv4/IPv6) para las redes de doble pila.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NetworkConfigurationServiceCidr

Intervalos IP de notación CIDR desde los que se van a asignar direcciones IP de servicio. Se espera un CIDR IPv4 para las redes de una sola pila. Se esperan dos CIDR, uno para cada familia IP (IPv4/IPv6) para las redes de doble pila.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NoWait

Ejecutar el comando de forma asincrónica

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SshPublicKey

Configuración de SSH para los sistemas operativos que ejecutan los nodos en el clúster de Kubernetes. En algunos casos, es posible que se requiera la especificación de claves públicas para generar un entorno de trabajo. Para construir, consulte la sección NOTES de las propiedades SSHPUBLICKEY y cree una tabla hash.

Tipo:ISshPublicKey[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SubscriptionId

Identificador de la suscripción de destino. El valor debe ser un UUID.

Tipo:String
Posición:Named
Valor predeterminado:(Get-AzContext).Subscription.Id
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Tag

Etiquetas del recurso.

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Salidas

IKubernetesCluster