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

Typ:

IL2NetworkAttachmentConfiguration[]

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

-AttachedNetworkConfigurationL3Network

Listan över Layer 3-nätverk och relaterad konfiguration för bifogad fil.

Parameteregenskaper

Typ:

IL3NetworkAttachmentConfiguration[]

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

-AttachedNetworkConfigurationTrunkedNetwork

Listan över trunkerade nätverk och relaterad konfiguration för bifogad fil.

Parameteregenskaper

Typ:

ITrunkedNetworkAttachmentConfiguration[]

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

-BgpAdvertisement

Associationen av IP-adresspooler till communities och peer-datorer, vilket möjliggör tillkännagivande av IP-adresser.

Parameteregenskaper

Typ:

IBgpAdvertisement[]

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

-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

Typ:

IServiceLoadBalancerBgpPeer[]

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

-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

Typ:

IInitialAgentPoolConfiguration[]

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

-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

IKubernetesCluster