New-AzNetworkCloudAgentPool

Sintassi

CreateExpanded (Impostazione predefinita)

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterName <String>
    -ResourceGroupName <String>
    -Count <Int64>
    -Location <String>
    -Mode <String>
    -VMSkuName <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AdministratorConfigurationAdminUsername <String>]
    [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
    [-AgentOptionHugepagesCount <Int64>]
    [-AgentOptionHugepagesSize <String>]
    [-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>]

CreateViaJsonString

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterName <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterName <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityKubernetesClusterExpanded

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterInputObject <INetworkCloudIdentity>
    -Count <Int64>
    -Location <String>
    -Mode <String>
    -VMSkuName <String>
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AdministratorConfigurationAdminUsername <String>]
    [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
    [-AgentOptionHugepagesCount <Int64>]
    [-AgentOptionHugepagesSize <String>]
    [-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>]

Descrizione

Esempio

Esempio 1: Creare il pool di agenti del cluster 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>

Parametri

-AdministratorConfigurationAdminUsername

Nome utente per l'amministratore che verrà applicato ai sistemi operativi che eseguono nodi Kubernetes. Se non viene specificato, verrà scelto un nome utente dal servizio.

Proprietà dei parametri

Set di parametri

-AdministratorConfigurationSshPublicKey

Configurazione SSH per i sistemi operativi che eseguono i nodi nel cluster Kubernetes. In alcuni casi, la specifica delle chiavi pubbliche potrebbe essere necessaria per produrre un ambiente di lavoro.

Proprietà dei parametri

Set di parametri

-AgentOptionHugepagesCount

Numero di enormi pagine da allocare.

Proprietà dei parametri

Set di parametri

-AgentOptionHugepagesSize

Dimensioni delle enormi pagine da allocare.

Proprietà dei parametri

Set di parametri

-AsJob

Eseguire il comando come processo

Proprietà dei parametri

Set di parametri

-AttachedNetworkConfigurationL2Network

Elenco delle reti di livello 2 e della configurazione correlata per l'allegato.

Proprietà dei parametri

Set di parametri

-AttachedNetworkConfigurationL3Network

Elenco delle reti di livello 3 e della configurazione correlata per l'allegato.

Proprietà dei parametri

Set di parametri

-AttachedNetworkConfigurationTrunkedNetwork

Elenco di reti trunked e configurazione correlata per l'allegato.

Proprietà dei parametri

Set di parametri

-AvailabilityZone

Elenco delle zone di disponibilità del cluster Cloud di rete usato per il provisioning dei nodi in questo pool di agenti. Se non specificato, verranno usate tutte le zone di disponibilità.

Proprietà dei parametri

Set di parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Set di parametri

-Count

Numero di macchine virtuali che usano questa configurazione.

Proprietà dei parametri

Set di parametri

-DefaultProfile

Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.

Proprietà dei parametri

Set di parametri

-ExtendedLocationName

ID risorsa del percorso esteso in cui verrà creata la risorsa.

Proprietà dei parametri

Set di parametri

-ExtendedLocationType

Tipo di posizione estesa, ad esempio CustomLocation.

Proprietà dei parametri

Set di parametri

-IfMatch

ETag della trasformazione. Omettere questo valore per sovrascrivere sempre la risorsa corrente. Specificare l'ultimo valore ETag visualizzato per impedire la sovrascrittura accidentale delle modifiche simultanee.

Proprietà dei parametri

Set di parametri

-IfNoneMatch

Impostare su '*' per consentire la creazione di un nuovo set di record, ma per impedire l'aggiornamento di una risorsa esistente. Gli altri valori genereranno errori dal server perché non sono supportati.

Proprietà dei parametri

Set di parametri

-JsonFilePath

Percorso del file JSON fornito all'operazione di creazione

Proprietà dei parametri

Set di parametri

-JsonString

Stringa JSON fornita all'operazione di creazione

Proprietà dei parametri

Set di parametri

-KubernetesClusterInputObject

Parametro Identity

Proprietà dei parametri

Set di parametri

-KubernetesClusterName

Nome del cluster Kubernetes.

Proprietà dei parametri

Set di parametri

-Label

Etichette applicate ai nodi in questo pool di agenti.

Proprietà dei parametri

Set di parametri

-Location

Posizione geografica in cui risiede la risorsa

Proprietà dei parametri

Set di parametri

-Mode

Selezione della modalità di utilizzo del pool di agenti, come pool di sistema o pool di utenti. I pool di sistema eseguono le funzionalità e i servizi critici per il cluster Kubernetes, mentre i pool di utenti sono dedicati ai carichi di lavoro degli utenti. Ogni cluster Kubernetes deve contenere almeno un pool di nodi di sistema con almeno un nodo.

Proprietà dei parametri

Set di parametri

-Name

Nome del pool di agenti del cluster Kubernetes.

Proprietà dei parametri

Set di parametri

-NoWait

Eseguire il comando in modo asincrono

Proprietà dei parametri

Set di parametri

-ResourceGroupName

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

Proprietà dei parametri

Set di parametri

-SubscriptionId

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.

Proprietà dei parametri

Set di parametri

-Tag

Tag delle risorse.

Proprietà dei parametri

Set di parametri

-Taint

I taints applicati ai nodi in questo pool di agenti.

Proprietà dei parametri

Set di parametri

-UpgradeSettingDrainTimeout

Tempo massimo in secondi consentito per il completamento di uno svuotamento del nodo prima di procedere con l'aggiornamento del pool di agenti. Se non specificato durante la creazione, viene utilizzato un valore di 1800 secondi.

Proprietà dei parametri

Set di parametri

-UpgradeSettingMaxSurge

Numero massimo o percentuale di nodi che vengono distribuiti durante l'aggiornamento. Può essere impostato su un numero intero ,ad esempio '5', o su una percentuale (ad esempio , '50%'). Se viene specificata una percentuale, corrisponde alla percentuale delle dimensioni totali del pool di agenti al momento dell'aggiornamento. Per le percentuali, i nodi frazionari vengono arrotondati. Se non specificato durante la creazione, viene utilizzato un valore pari a 1. Uno di MaxSurge e MaxUnavailable deve essere maggiore di 0.

Proprietà dei parametri

Set di parametri

-UpgradeSettingMaxUnavailable

Numero massimo o percentuale di nodi che possono non essere disponibili durante l'aggiornamento. Può essere impostato su un numero intero ,ad esempio '5', o su una percentuale (ad esempio , '50%'). Se viene specificata una percentuale, corrisponde alla percentuale delle dimensioni totali del pool di agenti al momento dell'aggiornamento. Per le percentuali, i nodi frazionari vengono arrotondati. Se non specificato durante la creazione, viene utilizzato un valore pari a 0. Uno di MaxSurge e MaxUnavailable deve essere maggiore di 0.

Proprietà dei parametri

Set di parametri

-VMSkuName

Nome dello SKU della macchina virtuale che determina le dimensioni delle risorse allocate per le macchine virtuali del nodo.

Proprietà dei parametri

Set di parametri

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Set di parametri

CommonParameters

Input

INetworkCloudIdentity

Output

IAgentPool