New-AzNetworkCloudAgentPool

Referencia

Módulo:: Az.NetworkCloud

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

Sintaxis

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[]>]
   [-UpgradeSettingMaxSurge <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

Ejemplos

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

Este comando crea un grupo de agentes para el clúster de Kubernetes determinado.

Parámetros

-AdministratorConfigurationAdminUsername

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

-AdministratorConfigurationSshPublicKey

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 ADMINISTRATORCONFIGURATIONSSHPUBLICKEY 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

-AgentOptionHugepagesCount

Número de enormes páginas que se van a asignar.

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

-AgentOptionHugepagesSize

Tamaño de las enormes páginas que se van a asignar.

Tipo:	HugepagesSize
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

-AvailabilityZone

Lista de zonas de disponibilidad del clúster de nube de red que se usa para el aprovisionamiento de nodos en este grupo de agentes. 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

-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

-Count

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

-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:	False
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:	False
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

-Label

Etiquetas aplicadas a los nodos de este grupo de agentes. Para construir, consulte la sección NOTES para las propiedades LABEL y crear una tabla hash.

Tipo:	IKubernetesLabel[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
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

-Mode

La selección de cómo se utiliza este grupo de agentes, ya sea como un grupo de sistemas o un grupo de usuarios. Los grupos de sistemas ejecutan las características y los servicios críticos para el clúster de Kubernetes, mientras que los grupos de usuarios están dedicados a las cargas de trabajo de usuario. Cada clúster de Kubernetes debe contener al menos un grupo de nodos del sistema con al menos un nodo.

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

-Name

Nombre del grupo de agentes de clúster de Kubernetes.

Tipo:	String
Alias:	AgentPoolName
Posición:	Named
Valor predeterminado:	None
Requerido:	True
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

-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

-Taint

Los valores taint aplicados a los nodos de este grupo de agentes. Para construir, consulte la sección NOTES de las propiedades TAINT y cree una tabla hash.

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

-UpgradeSettingMaxSurge

Número máximo o porcentaje de nodos que se sobrecargan durante la actualización. Esto puede establecerse en un entero (por ejemplo, "5") o en un porcentaje (por ejemplo, "50%"). Si se especifica un porcentaje, es el porcentaje del tamaño total del grupo de agentes en el momento de la actualización. En porcentajes, los nodos fraccionarios se redondean hacia arriba. Si no se especifica, el valor predeterminado es 1.

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

-VMSkuName

Nombre de la SKU de máquina virtual que determina el tamaño de los recursos asignados para las máquinas virtuales de nodo.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
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

IAgentPool

Compartir a través de