New-AzNetworkCloudKubernetesCluster
Skapa ett nytt Kubernetes-kluster eller skapa egenskaperna för det befintliga.
Syntax
CreateExpanded (Standard)
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>]
Description
Skapa ett nytt Kubernetes-kluster eller skapa egenskaperna för det befintliga.
Exempel
Exempel 1: Skapa Kubernetes-kluster
$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
Det här kommandot skapar ett Kubernetes-kluster.
Parametrar
-AadConfigurationAdminGroupObjectId
Listan över Azure Active Directory-gruppobjekt-ID:er som ska ha en administrativ roll i Kubernetes-klustret.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-AdminUsername
Användarnamnet för administratören som ska tillämpas på de operativsystem som kör Kubernetes-noder.
Om det inte anges väljs ett användarnamn av tjänsten.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-AsJob
Kör kommandot som ett jobb
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-AttachedNetworkConfigurationL2Network
Listan över Layer 2-nätverk och relaterad konfiguration för bifogad fil.
Parameteregenskaper
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-AttachedNetworkConfigurationL3Network
Listan över Layer 3-nätverk och relaterad konfiguration för bifogad fil.
Parameteregenskaper
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-AttachedNetworkConfigurationTrunkedNetwork
Listan över trunkerade nätverk och relaterad konfiguration för bifogad fil.
Parameteregenskaper
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-BgpAdvertisement
Associationen av IP-adresspooler till communities och peer-datorer, vilket möjliggör tillkännagivande av IP-adresser.
Parameteregenskaper
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-BgpIPAddressPool
Listan över pooler med IP-adresser som kan allokeras till lastbalanseringstjänster.
Parameteregenskaper
Typ: IIPAddressPool [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-BgpPeer
Listan över ytterligare BgpPeer-entiteter som Kubernetes-klustret ska peerkopplas med.
All peering måste definieras explicit.
Parameteregenskaper
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled
Indikatorn för att ange om lastbalanseraren peer-datorer med nätverksinfrastrukturen.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: jfr
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ControlPlaneNodeConfigurationAdminPublicKey
SSH-konfigurationen för de operativsystem som kör noderna i Kubernetes-klustret.
I vissa fall kan det krävas specifikation av offentliga nycklar för att skapa en arbetsmiljö.
Parameteregenskaper
Typ: ISshPublicKey [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ControlPlaneNodeConfigurationAdminUsername
Användarnamnet för administratören som ska tillämpas på de operativsystem som kör Kubernetes-noder.
Om det inte anges väljs ett användarnamn av tjänsten.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ControlPlaneNodeConfigurationAvailabilityZone
Listan över tillgänglighetszoner för network cloud-klustret som ska användas för etablering av noder i kontrollplanet.
Om det inte anges används alla tillgänglighetszoner.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ControlPlaneNodeConfigurationCount
Antalet virtuella datorer som använder den här konfigurationen.
Parameteregenskaper
Typ: Int64
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ControlPlaneNodeConfigurationVMSkuName
Namnet på den virtuella dator-SKU som angavs när den skapades.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-DefaultProfile
Parametern DefaultProfile fungerar inte.
Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.
Parameteregenskaper
Typ: PSObject
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: AzureRMContext, AzureCredential
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ExtendedLocationName
Resurs-ID för den utökade plats där resursen ska skapas.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ExtendedLocationType
Den utökade platstypen, till exempel CustomLocation.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-IfMatch
ETag för omvandlingen.
Utelämna det här värdet för att alltid skriva över den aktuella resursen.
Ange det senast synliga ETag-värdet för att förhindra att samtidiga ändringar skrivs över av misstag.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-IfNoneMatch
Ange till *för att tillåta att en ny postuppsättning skapas, men för att förhindra uppdatering av en befintlig resurs.
Andra värden resulterar i fel från servern eftersom de inte stöds.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-InitialAgentPoolConfiguration
Agentpoolerna som skapas med det här Kubernetes-klustret för att köra kritiska systemtjänster och arbetsbelastningar.
Dessa data i det här fältet används endast när de skapas och fältet kommer att vara tomt när Kubernetes-klustret har skapats.
När du har skapat dem utförs hanteringen av agentpooler med hjälp av underresursen agentPools.
Parameteregenskaper
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-JsonFilePath
Sökväg till Json-fil som angetts för åtgärden Skapa
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateViaJsonFilePath
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-JsonString
Json-sträng som har angetts för åtgärden Skapa
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateViaJsonString
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-KubernetesVersion
Kubernetes-versionen för det här klustret.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-L2ServiceLoadBalancerConfigurationIPAddressPool
Listan över pooler med IP-adresser som kan allokeras till lastbalanseringstjänster.
Parameteregenskaper
Typ: IIPAddressPool [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Location
Den geo-plats där resursen finns
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ManagedResourceGroupConfigurationLocation
Platsen för den hanterade resursgruppen.
Om det inte anges väljs platsen för den överordnade resursen.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ManagedResourceGroupConfigurationName
Namnet på den hanterade resursgruppen.
Om det inte anges genereras det unika namnet automatiskt.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Name
Namnet på Kubernetes-klustret.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: KubernetesClusterName
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-NetworkConfigurationCloudServicesNetworkId
Resurs-ID för det associerade Cloud Services-nätverket.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-NetworkConfigurationCniNetworkId
Resurs-ID:t för Layer 3-nätverket som används för att skapa nätverket för containernätverksgränssnittet.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-NetworkConfigurationDnsServiceIP
IP-adressen som tilldelats Kubernetes DNS-tjänsten.
Den måste ligga inom kubernetes-tjänstens adressintervall som anges i tjänst-CIDR.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-NetworkConfigurationPodCidr
IP-adressintervallen för CIDR-notation för att tilldela podd-IP-adresser.
En IPv4 CIDR förväntas för enstacknätverk.
Två CIDR:er, en för varje IP-familj (IPv4/IPv6), förväntas för nätverk med dubbla staplar.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-NetworkConfigurationServiceCidr
CIDR-notations-IP-adressintervallen för att tilldela tjänst-IP-adresser.
En IPv4 CIDR förväntas för enstacknätverk.
Två CIDR:er, en för varje IP-familj (IPv4/IPv6), förväntas för nätverk med dubbla staplar.
Parameteregenskaper
Typ: String [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-NoWait
Kör kommandot asynkront
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ResourceGroupName
Namnet på resursgruppen.
Namnet är skiftlägesokänsligt.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-SshPublicKey
SSH-konfigurationen för de operativsystem som kör noderna i Kubernetes-klustret.
I vissa fall kan det krävas specifikation av offentliga nycklar för att skapa en arbetsmiljö.
Parameteregenskaper
Typ: ISshPublicKey [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-SubscriptionId
ID för målprenumerationen.
Värdet måste vara ett UUID.
Parameteregenskaper
Typ: String
Standardvärde: (Get-AzContext).Subscription.Id
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Tag
Resursetiketter.
Parameteregenskaper
Typ: Hashtable
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
CreateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-WhatIf
Visar vad som skulle hända om kommandot körs.
Cmdleten körs inte.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: Wi
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters .
Utdata