Condividi tramite

New-AzNetworkCloudKubernetesCluster

  • Riferimento
Modulo:
Az.NetworkCloud

Creare un nuovo cluster Kubernetes o aggiornare le proprietà di quella esistente.

Sintassi

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

Descrizione

Creare un nuovo cluster Kubernetes o aggiornare le proprietà di quella esistente.

Esempio

Esempio 1: Creare un cluster 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

Questo comando crea un cluster Kubernetes.

Parametri

-AadConfigurationAdminGroupObjectId

Elenco di ID oggetto gruppo di Azure Active Directory che avranno un ruolo amministrativo nel cluster Kubernetes.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AdminUsername

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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AsJob

Eseguire il comando come processo

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AttachedNetworkConfigurationL2Network

Elenco delle reti di livello 2 e della configurazione correlata per l'allegato. Per costruire, vedere la sezione NOTES per ATTACHEDNETWORKCONFIGURATIONL2NETWORK proprietà e creare una tabella hash.

Tipo:IL2NetworkAttachmentConfiguration[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AttachedNetworkConfigurationL3Network

Elenco delle reti di livello 3 e della configurazione correlata per l'allegato. Per costruire, vedere la sezione NOTES per ATTACHEDNETWORKCONFIGURATIONL3NETWORK proprietà e creare una tabella hash.

Tipo:IL3NetworkAttachmentConfiguration[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AttachedNetworkConfigurationTrunkedNetwork

Elenco di reti trunked e configurazione correlata per l'allegato. Per costruire, vedere la sezione NOTES per le proprietà ATTACHEDNETWORKCONFIGURATIONTRUNKEDNETWORK e creare una tabella hash.

Tipo:ITrunkedNetworkAttachmentConfiguration[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BgpAdvertisement

L'associazione di pool di indirizzi IP alle community e ai peer, consentendo l'annuncio di indirizzi IP. Per costruire, vedere la sezione NOTES per le proprietà BGPADVERTISEMENT e creare una tabella hash.

Tipo:IBgpAdvertisement[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BgpIPAddressPool

Elenco di pool di indirizzi IP che possono essere allocati ai servizi di bilanciamento del carico. Per costruire, vedere la sezione NOTES per le proprietà BGPIPADDRESSPOOL e creare una tabella hash.

Tipo:IIPAddressPool[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BgpPeer

Elenco di entità BgpPeer aggiuntive con cui il cluster Kubernetes eseguirà il peering. Tutto il peering deve essere definito in modo esplicito. Per costruire, vedere la sezione NOTES per le proprietà BGPPEER e creare una tabella hash.

Tipo:IServiceLoadBalancerBgpPeer[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

Indicatore da specificare se il servizio di bilanciamento del carico esegue il peering con l'infrastruttura di rete.

Tipo:FabricPeeringEnabled
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ControlPlaneNodeConfigurationAdminPublicKey

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. Per costruire, vedere la sezione NOTES per le proprietà CONTROLPLANENODECONFIGURATIONADMINPU ROUTEEY e creare una tabella hash.

Tipo:ISshPublicKey[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ControlPlaneNodeConfigurationAdminUsername

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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ControlPlaneNodeConfigurationAvailabilityZone

Elenco delle zone di disponibilità del cluster Cloud di rete da usare per il provisioning dei nodi nel piano di controllo. Se non specificato, verranno usate tutte le zone di disponibilità.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ControlPlaneNodeConfigurationCount

Numero di macchine virtuali che usano questa configurazione.

Tipo:Int64
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ControlPlaneNodeConfigurationVMSkuName

Nome dello SKU della macchina virtuale fornito durante la creazione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

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

Tipo:PSObject
Alias:AzureRMContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExtendedLocationName

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExtendedLocationType

Tipo di posizione estesa, ad esempio CustomLocation.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InitialAgentPoolConfiguration

Pool di agenti creati con questo cluster Kubernetes per l'esecuzione di carichi di lavoro e servizi di sistema critici. Questi dati in questo campo vengono usati solo durante la creazione e il campo sarà vuoto dopo la creazione del cluster Kubernetes. Dopo la creazione, la gestione dei pool di agenti viene eseguita usando la sotto-risorsa agentPools. Per costruire, vedere la sezione NOTES per le proprietà INITIALAGENTPOOLCONFIGURATION e creare una tabella hash.

Tipo:IInitialAgentPoolConfiguration[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-KubernetesClusterName

Nome del cluster Kubernetes.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-KubernetesVersion

Versione di Kubernetes per questo cluster.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-L2ServiceLoadBalancerConfigurationIPAddressPool

Elenco di pool di indirizzi IP che possono essere allocati ai servizi di bilanciamento del carico. Per costruire, vedere la sezione NOTES per L2SERVICELOADBALANCERCONFIGURATIONIPADDRESSPOOL proprietà e creare una tabella hash.

Tipo:IIPAddressPool[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Location

Posizione geografica in cui risiede la risorsa

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ManagedResourceGroupConfigurationLocation

Posizione del gruppo di risorse gestite. Se non specificato, viene scelta la posizione della risorsa padre.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ManagedResourceGroupConfigurationName

Nome del gruppo di risorse gestite. Se non specificato, il nome univoco viene generato automaticamente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NetworkConfigurationCloudServicesNetworkId

ID risorsa della rete di Servizi cloud associata.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NetworkConfigurationCniNetworkId

ID risorsa della rete di livello 3 usata per la creazione della rete dell'interfaccia di rete contenitore.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NetworkConfigurationDnsServiceIP

Indirizzo IP assegnato al servizio DNS Kubernetes. Deve essere compreso nell'intervallo di indirizzi del servizio Kubernetes specificato nel CIDR del servizio.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NetworkConfigurationPodCidr

Intervallo IP di notazione CIDR da cui assegnare indirizzi IP pod. È previsto un CIDR IPv4 per la rete a stack singolo. Due CIDR, uno per ogni famiglia IP (IPv4/IPv6), è previsto per la rete dual stack.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NetworkConfigurationServiceCidr

Intervallo IP di notazione CIDR da cui assegnare gli INDIRIZZI IP del servizio. È previsto un CIDR IPv4 per la rete a stack singolo. Due CIDR, uno per ogni famiglia IP (IPv4/IPv6), è previsto per la rete dual stack.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NoWait

Eseguire il comando in modo asincrono

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SshPublicKey

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. Per costruire, vedere la sezione NOTES per le proprietà SSHPU ROUTEEY e creare una tabella hash.

Tipo:ISshPublicKey[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SubscriptionId

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

Tipo:String
Posizione:Named
Valore predefinito:(Get-AzContext).Subscription.Id
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Tag

Tag di risorsa.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Output