Share via


New-AzConnectedKubernetes

API zum Registrieren eines neuen Kubernetes-Clusters und Erstellen einer nachverfolgten Ressource in Azure Resource Manager (ARM).

Syntax

New-AzConnectedKubernetes
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-HttpProxy <Uri>]
   [-HttpsProxy <Uri>]
   [-NoProxy <String>]
   [-ProxyCert <String>]
   [-OnboardingTimeout <Int32>]
   [-DisableAutoUpgrade]
   [-ContainerLogPath <String>]
   -Location <String>
   [-KubeConfig <String>]
   [-KubeContext <String>]
   [-AzureHybridBenefit <AzureHybridBenefit>]
   [-Distribution <String>]
   [-DistributionVersion <String>]
   [-Infrastructure <String>]
   [-PrivateLinkScopeResourceId <String>]
   [-PrivateLinkState <PrivateLinkState>]
   [-ProvisioningState <ProvisioningState>]
   [-Tag <Hashtable>]
   [-CustomLocationsOid <String>]
   [-AcceptEULA]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

API zum Registrieren eines neuen Kubernetes-Clusters und Erstellen einer nachverfolgten Ressource in Azure Resource Manager (ARM).

Beispiele

Beispiel 1: Erstellen einer verbundenen Kubernetes.

New-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -Location eastus

Location Name              ResourceGroupName
-------- ----              -----------------
eastus   azps_test_cluster azps_test_group

Mit diesem Befehl wird ein verbundenes Kubernetes erstellt.

Beispiel 2: Erstellen sie eine verbundene Kubernetes mit den Parametern kubeConfig und kubeContext.

New-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -Location eastus -KubeConfig $HOME\.kube\config -KubeContext azps_aks_t01

Location Name              ResourceGroupName
-------- ----              -----------------
eastus   azps_test_cluster azps_test_group

Mit diesem Befehl wird ein verbundenes Kubernetes mit den Parametern kubeConfig und kubeContext erstellt.

Beispiel 3: Erstellen eines Verbinden edKubernetes AzureHybridBenefit.

New-AzConnectedKubernetes -ClusterName azps_test_cluster_ahb -ResourceGroupName azps_test_group -Location eastus -KubeConfig $HOME\.kube\config -KubeContext azps_aks_t01 -PrivateLinkState 'Enabled' -Distribution "AKS_Management" -DistributionVersion "1.0" -PrivateLinkScopeResourceId "/subscriptions/{subscriptionId}/resourceGroups/azps_test_group/providers/Microsoft.HybridCompute/privateLinkScopes/azps-privatelinkscope" -infrastructure "azure_stack_hci" -ProvisioningState 'Succeeded' -AzureHybridBenefit 'True'

I confirm I have an eligible Windows Server license with Azure Hybrid Benefit to apply this benefit to AKS on Azure Stack HCI or Windows Server. Visit https://aka.ms/ahb-aks for details.
[Y] Yes  [N] No  (default is "N"): Y

Location Name                  ResourceGroupName
-------- ----                  -----------------
eastus   azps_test_cluster_ahb azps_test_group

Erstellen Sie ein Verbinden edKubernetes AzureHybridBenefit.

Beispiel 4: Die Verwendung von [-AcceptEULA] übernimmt standardmäßig Ihre Annahme der Bedingungen unserer Gesetzlichen Vereinbarung und erstellt eine verbundene Kubernetes.

New-AzConnectedKubernetes -ClusterName azps_test_cluster_ahb -ResourceGroupName azps_test_group -Location eastus -KubeConfig $HOME\.kube\config -KubeContext azps_aks_t01 -PrivateLinkState 'Enabled' -Distribution "AKS_Management" -DistributionVersion "1.0" -PrivateLinkScopeResourceId "/subscriptions/{subscriptionId}/resourceGroups/azps_test_group/providers/Microsoft.HybridCompute/privateLinkScopes/azps-privatelinkscope" -infrastructure "azure_stack_hci" -ProvisioningState 'Succeeded' -AzureHybridBenefit 'True' -AcceptEULA

Location Name                  ResourceGroupName
-------- ----                  -----------------
eastus   azps_test_cluster_ahb azps_test_group

Durch die Verwendung von [-AcceptEULA] erhalten Sie standardmäßig die Annahme der Bestimmungen unserer Gesetzlichen Vereinbarung und erstellen eine verbundene Kubernetes.

Beispiel 5: Erstellen sie eine verbundene Kubernetes mit Parametern HttpProxy, HttpsProxy, NoProxy und Proxy.

New-AzConnectedKubernetes -ClusterName azps_test_cluster_ahb -ResourceGroupName azps_test_group -Location eastus -KubeConfig $HOME\.kube\config -KubeContext azps_aks_t01 -HttpProxy "http://proxy-user:proxy-password@proxy-ip:port" -HttpsProxy "http://proxy-user:proxy-password@proxy-ip:port" -NoProxy "localhost,127.0.0.0/8,192.168.0.0/16,172.17.0.0/16,10.96.0.0/12,10.244.0.0/16,10.43.0.0/24,.svc" -Proxy "http://proxy-user:proxy-password@proxy-ip:port"

Location Name                  ResourceGroupName
-------- ----                  -----------------
eastus   azps_test_cluster_ahb azps_test_group

Mit diesem Befehl wird ein verbundenes Kubernetes mit Parametern HttpProxy, HttpsProxy, NoProxy und Proxy erstellt.

Beispiel 6: Erstellen eines verbundenen Kubernetes mit Parametern HttpProxy, HttpsProxy, NoProxy, Proxy und ProxyCredential.

$pwd = ConvertTo-SecureString "proxy-password" -AsPlainText -Force
$cred = New-Object System.Management.Automation.PSCredential ("proxy-user", $pwd)
New-AzConnectedKubernetes -ClusterName azps_test_cluster_ahb -ResourceGroupName azps_test_group -Location eastus -KubeConfig $HOME\.kube\config -KubeContext azps_aks_t01 -HttpProxy "http://proxy-user:proxy-password@proxy-ip:port" -HttpsProxy "http://proxy-user:proxy-password@proxy-ip:port" -NoProxy "localhost,127.0.0.0/8,192.168.0.0/16,172.17.0.0/16,10.96.0.0/12,10.244.0.0/16,10.43.0.0/24,.svc" -Proxy "http://proxy-ip:port" -ProxyCredential $cred

Location Name                  ResourceGroupName
-------- ----                  -----------------
eastus   azps_test_cluster_ahb azps_test_group

Mit diesem Befehl wird ein verbundenes Kubernetes mit Parametern HttpProxy, HttpsProxy, NoProxy, Proxy und ProxyCredential erstellt.

Beispiel 7: Erstellen Sie eine verbundene Kubernetes, und deaktivieren Sie das automatische Upgrade von Arc-Agents.

New-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -Location eastus -DisableAutoUpgrade

Location Name              ResourceGroupName
-------- ----              -----------------
eastus   azps_test_cluster azps_test_group

Mit diesem Befehl wird ein verbundenes Kubernetes erstellt und das automatische Upgrade von Arc-Agents deaktiviert.

Beispiel 8: Erstellen eines verbundenen Kubernetes mit benutzerdefiniertem Onboarding-Timeout.

New-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -Location eastus -OnboardingTimeout 600

Location Name              ResourceGroupName
-------- ----              -----------------
eastus   azps_test_cluster azps_test_group

Mit diesem Befehl wird ein verbundenes Kubernetes mit benutzerdefiniertem Onboarding-Timeout erstellt.

Parameter

-AcceptEULA

Akzeptieren der EULA von Verbinden edKubernetes, rechtliche Begriff wird ohne diesen Parameter angezeigt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AsJob

Ausführen des Befehls als Auftrag

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AzureHybridBenefit

Gibt an, ob Azure-Hybridvorteil aktiviert ist.

Type:AzureHybridBenefit
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClusterName

Der Name des Kubernetes-Clusters, auf dem get aufgerufen wird.

Type:String
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContainerLogPath

Überschreiben Sie den Standardmäßigen Containerprotokollpfad, um die Fluent-Bit-Protokollierung zu aktivieren.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomLocationsOid

OID der App "custom-locations".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableAutoUpgrade

Kennzeichnen, um das automatische Upgrade von Arc-Agents zu deaktivieren.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Distribution

Die Kubernetes-Verteilung, die auf diesem verbundenen Cluster ausgeführt wird.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DistributionVersion

Die Kubernetes-Verteilungsversion auf diesem verbundenen Cluster.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HttpProxy

Der HTTP-URI des Proxyservers für den kubernetes-Cluster, der verwendet werden soll

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HttpsProxy

Der https-URI des Zu verwendenden Kubernetes-Clusters des Proxyservers

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Infrastructure

Die Infrastruktur, auf der der Kubernetes-Cluster, der durch diesen verbundenen Cluster dargestellt wird, ausgeführt wird.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KubeConfig

Pfad zur Kube-Konfigurationsdatei

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KubeContext

Kubconfig-Kontext vom aktuellen Computer

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Der geografische Standort, an dem sich die Ressource befindet

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoProxy

Die durch Trennzeichen getrennte Liste der Hostnamen, die vom Proxyserver für den kubernetes-Cluster ausgeschlossen werden sollen

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

Asynchrones Ausführen des Befehls

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnboardingTimeout

Die erforderliche Zeit (in Sekunden), damit die Arc-Agent-Pods auf dem Kubernetes-Cluster installiert werden.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateLinkScopeResourceId

Die Ressourcen-ID des privaten Verknüpfungsbereichs, dem dieser verbundene Cluster zugewiesen ist, falls vorhanden.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateLinkState

Eigenschaft, die den Status der privaten Verknüpfung in einer verbundenen Clusterressource beschreibt.

Type:PrivateLinkState
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProvisioningState

Bereitstellungsstatus der verbundenen Clusterressource.

Type:ProvisioningState
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyCert

Der Pfad zur Zertifikatdatei für proxy- oder benutzerdefinierte Zertifizierungsstelle.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Hierbei handelt es sich um die ID des Zielabonnements.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Ressourcentags.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

IConnectedCluster

Hinweise

ALIASE