New-AzNetworkCloudKubernetesCluster
Creare un nuovo cluster Kubernetes o crearne le proprietà esistenti.
Sintassi
CreateExpanded (Impostazione predefinita)
New-AzNetworkCloudKubernetesCluster
-Name <String>
-ResourceGroupName <String>
-ControlPlaneNodeConfigurationCount <Int64>
-ControlPlaneNodeConfigurationVMSkuName <String>
-ExtendedLocationName <String>
-ExtendedLocationType <String>
-InitialAgentPoolConfiguration <IInitialAgentPoolConfiguration[]>
-KubernetesVersion <String>
-Location <String>
-NetworkConfigurationCloudServicesNetworkId <String>
-NetworkConfigurationCniNetworkId <String>
[-SubscriptionId <String>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-AadConfigurationAdminGroupObjectId <String[]>]
[-AdminUsername <String>]
[-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
[-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
[-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
[-BgpAdvertisement <IBgpAdvertisement[]>]
[-BgpIPAddressPool <IIPAddressPool[]>]
[-BgpPeer <IServiceLoadBalancerBgpPeer[]>]
[-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled <String>]
[-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>]
CreateViaJsonFilePath
New-AzNetworkCloudKubernetesCluster
-Name <String>
-ResourceGroupName <String>
-JsonFilePath <String>
[-SubscriptionId <String>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonString
New-AzNetworkCloudKubernetesCluster
-Name <String>
-ResourceGroupName <String>
-JsonString <String>
[-SubscriptionId <String>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Creare un nuovo cluster Kubernetes o crearne le proprietà esistenti.
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.
Proprietà dei parametri
Tipo: String [ ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: 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.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-AsJob
Eseguire il comando come processo
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-AttachedNetworkConfigurationL2Network
Elenco delle reti di livello 2 e della configurazione correlata per l'allegato.
Proprietà dei parametri
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-AttachedNetworkConfigurationL3Network
Elenco delle reti di livello 3 e della configurazione correlata per l'allegato.
Proprietà dei parametri
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-AttachedNetworkConfigurationTrunkedNetwork
Elenco di reti trunked e configurazione correlata per l'allegato.
Proprietà dei parametri
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-BgpAdvertisement
L'associazione di pool di indirizzi IP alle community e ai peer, consentendo l'annuncio di indirizzi IP.
Proprietà dei parametri
Tipo: IBgpAdvertisement [ ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-BgpIPAddressPool
Elenco di pool di indirizzi IP che possono essere allocati ai servizi di bilanciamento del carico.
Proprietà dei parametri
Tipo: IIPAddressPool [ ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-BgpPeer
Elenco di entità BgpPeer aggiuntive con cui il cluster Kubernetes eseguirà il peering.
Tutto il peering deve essere definito in modo esplicito.
Proprietà dei parametri
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled
Indicatore da specificare se il servizio di bilanciamento del carico esegue il peering con l'infrastruttura di rete.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: Cfr
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: 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.
Proprietà dei parametri
Tipo: ISshPublicKey [ ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: 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.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: 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à.
Proprietà dei parametri
Tipo: String [ ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ControlPlaneNodeConfigurationCount
Numero di macchine virtuali che usano questa configurazione.
Proprietà dei parametri
Tipo: Int64
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ControlPlaneNodeConfigurationVMSkuName
Nome dello SKU della macchina virtuale fornito durante la creazione.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-DefaultProfile
Il parametro DefaultProfile non è funzionale.
Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.
Proprietà dei parametri
Tipo: PSObject
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: AzureRMContext, AzureCredential
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ExtendedLocationName
ID risorsa del percorso esteso in cui verrà creata la risorsa.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ExtendedLocationType
Tipo di posizione estesa, ad esempio CustomLocation.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-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
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-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
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: 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.
Proprietà dei parametri
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-JsonFilePath
Percorso del file JSON fornito all'operazione di creazione
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateViaJsonFilePath
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-JsonString
Stringa JSON fornita all'operazione di creazione
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateViaJsonString
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-KubernetesVersion
Versione di Kubernetes per questo cluster.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-L2ServiceLoadBalancerConfigurationIPAddressPool
Elenco di pool di indirizzi IP che possono essere allocati ai servizi di bilanciamento del carico.
Proprietà dei parametri
Tipo: IIPAddressPool [ ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-Location
Posizione geografica in cui risiede la risorsa
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ManagedResourceGroupConfigurationLocation
Posizione del gruppo di risorse gestite.
Se non specificato, viene scelta la posizione della risorsa padre.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ManagedResourceGroupConfigurationName
Nome del gruppo di risorse gestite.
Se non specificato, il nome univoco viene generato automaticamente.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-Name
Nome del cluster Kubernetes.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: KubernetesClusterName
Set di parametri
(All)
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-NetworkConfigurationCloudServicesNetworkId
ID risorsa della rete di Servizi cloud associata.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-NetworkConfigurationCniNetworkId
ID risorsa della rete di livello 3 usata per la creazione della rete dell'interfaccia di rete contenitore.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-NetworkConfigurationDnsServiceIP
Indirizzo IP assegnato al servizio DNS Kubernetes.
Deve essere compreso nell'intervallo di indirizzi del servizio Kubernetes specificato nel CIDR del servizio.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: 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.
Proprietà dei parametri
Tipo: String [ ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: 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.
Proprietà dei parametri
Tipo: String [ ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-NoWait
Eseguire il comando in modo asincrono
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-ResourceGroupName
Nome del gruppo di risorse.
Il nome è insensibile alle maiuscole e minuscole.
Proprietà dei parametri
Tipo: String
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: True
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: 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.
Proprietà dei parametri
Tipo: ISshPublicKey [ ]
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-SubscriptionId
ID della sottoscrizione di destinazione.
Il valore deve essere un UUID.
Proprietà dei parametri
Tipo: String
Valore predefinito: (Get-AzContext).Subscription.Id
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-Tag
Tag delle risorse.
Proprietà dei parametri
Tipo: Hashtable
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Set di parametri
CreateExpanded
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet.
Il cmdlet non viene eseguito.
Proprietà dei parametri
Tipo: SwitchParameter
Valore predefinito: None
Supporta i caratteri jolly: False
DontShow: False
Alias: Wi
Set di parametri
(All)
Posizione: Named
Obbligatorio: False
Valore dalla pipeline: False
Valore dalla pipeline in base al nome della proprietà: False
Valore dagli argomenti rimanenti: False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters .
Output