az connectedk8s

Note

Deze verwijzing maakt deel uit van de connectedk8s-extensie voor de Azure CLI (versie 2.70.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az connectedk8s-opdracht uitvoert. Meer informatie over uitbreidingen.

Opdrachten voor het beheren van verbonden kubernetes-clusters.

Opdracht

Name	Description	Type	Status
az connectedk8s connect	Onboarding van een verbonden Kubernetes-cluster naar Azure.	Extension	GA
az connectedk8s delete	Verwijder een verbonden Kubernetes-cluster samen met verbonden clusteragents.	Extension	GA
az connectedk8s disable-features	Hiermee schakelt u de selectieve functies in het verbonden cluster uit.	Extension	Preview
az connectedk8s enable-features	Hiermee schakelt u de selectieve functies in het verbonden cluster in.	Extension	Preview
az connectedk8s list	Lijst met verbonden Kubernetes-clusters.	Extension	GA
az connectedk8s proxy	Toegang krijgen tot een verbonden Kubernetes-cluster.	Extension	GA
az connectedk8s show	Details van een verbonden kubernetes-cluster weergeven.	Extension	GA
az connectedk8s troubleshoot	Diagnostische controles uitvoeren op een Kubernetes-cluster met Arc.	Extension	Preview
az connectedk8s update	Werk de eigenschappen van het kubernetes-cluster met arc-onboarding bij.	Extension	GA
az connectedk8s upgrade	Atomisch upgraden van onboarded agents naar de specifieke versie of standaard naar de nieuwste versie.	Extension	GA

az connectedk8s connect

Onboarding van een verbonden Kubernetes-cluster naar Azure.

Het Kubernetes-cluster dat als verbonden cluster moet worden ge onboardd, moet het standaardcluster in kubeconfig zijn. Voer kubectl-configuratie get-contexts uit om de naam van de doelcontext te bevestigen. Stel vervolgens de standaardcontext in op het juiste cluster door kubectl config use-context target-cluster-name uit te voeren.

az connectedk8s connect --name
                        --resource-group
                        [--azure-hybrid-benefit {False, NotApplicable, True}]
                        [--config --configuration-settings]
                        [--config-protected --config-protected-settings]
                        [--container-log-path]
                        [--correlation-id]
                        [--custom-ca-cert --proxy-cert]
                        [--custom-locations-oid]
                        [--disable-auto-upgrade]
                        [--distribution {aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg}]
                        [--distribution-version]
                        [--enable-oidc-issuer {false, true}]
                        [--enable-private-link {false, true}]
                        [--enable-wi --enable-workload-identity {false, true}]
                        [--gateway-resource-id]
                        [--infrastructure {LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server}]
                        [--kube-config]
                        [--kube-context]
                        [--location]
                        [--no-wait]
                        [--onboarding-timeout]
                        [--pls-arm-id --private-link-scope-resource-id]
                        [--proxy-http]
                        [--proxy-https]
                        [--proxy-skip-range]
                        [--self-hosted-issuer]
                        [--skip-ssl-verification]
                        [--tags]
                        [--yes]

Voorbeelden

Onboarding van een verbonden Kubernetes-cluster met standaard kube-configuratie en kube-context.

az connectedk8s connect -g resourceGroupName -n connectedClusterName

Onboarding van een verbonden Kubernetes-cluster met standaard kube-configuratie en kube-context en het uitschakelen van automatische upgrade van Arc-agents.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --disable-auto-upgrade

Onboarding van een verbonden kubernetes-cluster door de kubeconfig en kubecontext op te geven.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

Onboarding van een verbonden Kubernetes-cluster door de https-proxy, http-proxy, geen proxy-instellingen op te geven.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

Onboarding van een verbonden Kubernetes-cluster door de https-proxy, http-proxy, geen proxy met certificaatinstellingen op te geven.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --proxy-cert /path/to/crt --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

Onboarding van een verbonden Kubernetes-cluster met private link-functie ingeschakeld door parameters voor private link op te geven.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-private-link true --private-link-scope-resource-id pls/resource/arm/id

Onboarding van een verbonden Kubernetes-cluster met een aangepaste time-out voor onboarding.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --onboarding-timeout 600

Onboarding van een verbonden Kubernetes-cluster met oidc-verlener en de webhook voor workloadidentiteit ingeschakeld.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

Onboarding van een verbonden Kubernetes-cluster met oidc-verlener ingeschakeld met behulp van een zelf-hostende URL voor een openbaar cloudcluster.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

Onboarding van een verbonden Kubernetes-cluster met azure Gateway-functie ingeschakeld.

az connectedk8s connect -g resourceGroupName -n connectedClusterName --gateway-resource-id gatewayResourceId

Vereiste parameters

--name -n

De naam van het verbonden cluster.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--azure-hybrid-benefit

Vlag om de functie Azure Hybrid Benefit in of uit te schakelen.

Eigenschap	Waarde
Geaccepteerde waarden:	False, NotApplicable, True

--config --configuration-settings

Preview

Configuratie-instellingen als sleutel-waardepaar. Herhaal de parameter voor elke instelling. Gebruik dit niet voor geheimen, omdat deze waarde als antwoord wordt geretourneerd.

--config-protected --config-protected-settings

Preview

Met configuratie beveiligde instellingen als sleutel=waardepaar. Herhaal de parameter voor elke instelling. Alleen de sleutel wordt als antwoord geretourneerd, de waarde is niet.

--container-log-path

Overschrijf het standaardpad voor containerlogboeken om fluent-bit-logboekregistratie in te schakelen.

--correlation-id

Een GUID die wordt gebruikt om intern de bron van onboarding van het cluster bij te houden. Wijzig deze pas aan tenzij u wordt geadviseerd.

--custom-ca-cert --proxy-cert

Pad naar het certificaatbestand voor proxy of aangepaste certificeringsinstantie.

Eigenschap	Waarde
Parametergroep:	Proxy Arguments

--custom-locations-oid

OID van de app 'custom-locations'.

--disable-auto-upgrade

Vlag om automatische upgrade van Arc-agents uit te schakelen.

Eigenschap	Waarde
Default value:	False

--distribution

De Kubernetes-distributie die wordt uitgevoerd op dit verbonden cluster.

Eigenschap	Waarde
Default value:	generic
Geaccepteerde waarden:	aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg

--distribution-version

De Kubernetes-distributieversie van het verbonden cluster.

--enable-oidc-issuer

Preview

Schakel het maken van de OIDC-verlener-URL in die wordt gebruikt voor federatie van workloadidentiteit.

Eigenschap	Waarde
Parametergroep:	Workload Identity Arguments
Default value:	False
Geaccepteerde waarden:	false, true

--enable-private-link

Preview

Vlag om ondersteuning voor private link in of uit te schakelen voor een verbonden clusterresource. Toegestane waarden: onwaar, waar.

Eigenschap	Waarde
Parametergroep:	PrivateLink Arguments
Geaccepteerde waarden:	false, true

--enable-wi --enable-workload-identity

Preview

Schakel de webhook voor workloadidentiteit in.

Eigenschap	Waarde
Parametergroep:	Workload Identity Arguments
Default value:	False
Geaccepteerde waarden:	false, true

--gateway-resource-id

Preview

ArmID van de Arc Gateway-resource.

Eigenschap	Waarde
Parametergroep:	Gateway Arguments

--infrastructure

De infrastructuur waarop het Kubernetes-cluster dat wordt vertegenwoordigd door dit verbonden cluster, wordt uitgevoerd.

Eigenschap

Waarde

Default value:

generic

Geaccepteerde waarden:

LTSCWindows 10 Enterprise LTSC, Windows 10 Enterprise, Windows 10 Enterprise LTSC 2019, Windows 10 Enterprise LTSC 2021, Windows 10 Enterprise N, Windows 10 Enterprise N LTSC 2019, Windows 10 Enterprise N LTSC 2021, Windows 10 IoT Enterprise, Windows 10 IoT Enterprise LTSC 2019, Windows 10 IoT Enterprise LTSC 2021, Windows 10 Pro, Windows 11 Enterprise, Windows 11 Enterprise N, Windows 11 IoT Enterprise, Windows 11 Pro, Windows Server 2019, Windows Server 2019 Datacenter, Windows Server 2019 Standard, Windows Server 2022, Windows Server 2022 Datacenter, Windows Server 2022 Standard, aws, azure, azure_stack_edge, azure_stack_hci, azure_stack_hub, gcp, generic, vsphere, windows_server

--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubconfig-context van de huidige computer.

--location -l

Location. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap	Waarde
Parametergroep:	Timeout Arguments
Default value:	False

--onboarding-timeout

De benodigde tijd (in seconden) voor de arc-agent-pods die op het kubernetes-cluster moeten worden geïnstalleerd. Overschrijf deze waarde als de hardware-/netwerkbeperkingen voor uw cluster meer tijd nodig hebben voor het installeren van de arc-agent-pods.

Eigenschap	Waarde
Parametergroep:	Timeout Arguments
Default value:	1200

--pls-arm-id --private-link-scope-resource-id

Preview

ARM-resource-id van de private link-bereikresource waaraan dit verbonden cluster is gekoppeld.

Eigenschap	Waarde
Parametergroep:	PrivateLink Arguments

--proxy-http

Http-proxy-URL die moet worden gebruikt.

Eigenschap	Waarde
Parametergroep:	Proxy Arguments

--proxy-https

Https-proxy-URL die moet worden gebruikt.

Eigenschap	Waarde
Parametergroep:	Proxy Arguments

--proxy-skip-range

Lijst met URL's/CIDR's waarvoor de proxy niet mag worden gebruikt.

Eigenschap	Waarde
Parametergroep:	Proxy Arguments

--self-hosted-issuer

Preview

Zelf-hostende URL voor openbare cloudclusters - AKS, GKE, EKS.

Eigenschap	Waarde
Parametergroep:	Workload Identity Arguments

--skip-ssl-verification

Sla SSL-verificatie over voor elke clusterverbinding.

Eigenschap	Waarde
Default value:	False

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

--yes -y

Niet vragen om bevestiging.

Eigenschap	Waarde
Default value:	False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedk8s delete

Verwijder een verbonden Kubernetes-cluster samen met verbonden clusteragents.

az connectedk8s delete [--force]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--yes]

Voorbeelden

Verwijder een verbonden kubernetes-cluster en verbonden clusteragents met standaard kubeconfig en kubecontext.

az connectedk8s delete -g resourceGroupName -n connectedClusterName

Verwijder een verbonden kubernetes-cluster door de kubeconfig en kubecontext op te geven voor verwijdering van verbonden clusteragents.

az connectedk8s delete -g resourceGroupName -n connectedClusterName --kube-config /path/to/kubeconfig --kube-context kubeContextName

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--force

Verwijder geforceerd om alle Azure-arc-resources uit het cluster te verwijderen.

Eigenschap	Waarde
Default value:	False

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubconfig-context van de huidige computer.

--name -n

De naam van het verbonden cluster.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap	Waarde
Default value:	False

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--skip-ssl-verification

Sla SSL-verificatie over voor elke clusterverbinding.

Eigenschap	Waarde
Default value:	False

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--yes -y

Niet vragen om bevestiging.

Eigenschap	Waarde
Default value:	False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedk8s disable-features

Preview

Deze opdracht is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Hiermee schakelt u de selectieve functies in het verbonden cluster uit.

az connectedk8s disable-features --features {azure-rbac, cluster-connect, custom-locations}
                                 [--ids]
                                 [--kube-config]
                                 [--kube-context]
                                 [--name]
                                 [--resource-group]
                                 [--skip-ssl-verification]
                                 [--subscription]
                                 [--yes]

Voorbeelden

Hiermee schakelt u de azure-rbac-functie uit.

az connectedk8s disable-features -n clusterName -g resourceGroupName --features azure-rbac

Schakel meerdere functies uit.

az connectedk8s disable-features -n clusterName -g resourceGroupName --features custom-locations azure-rbac

Vereiste parameters

--features

Door spaties gescheiden lijst met functies die u wilt uitschakelen.

Eigenschap	Waarde
Geaccepteerde waarden:	azure-rbac, cluster-connect, custom-locations

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--ids

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubconfig-context van de huidige computer.

--name -n

De naam van het verbonden cluster.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--skip-ssl-verification

Sla SSL-verificatie over voor elke clusterverbinding.

Eigenschap	Waarde
Default value:	False

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--yes -y

Niet vragen om bevestiging.

Eigenschap	Waarde
Default value:	False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedk8s enable-features

Preview

Deze opdracht is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Hiermee schakelt u de selectieve functies in het verbonden cluster in.

az connectedk8s enable-features --features {azure-rbac, cluster-connect, custom-locations}
                                [--custom-locations-oid]
                                [--ids]
                                [--kube-config]
                                [--kube-context]
                                [--name]
                                [--resource-group]
                                [--skip-azure-rbac-list]
                                [--skip-ssl-verification]
                                [--subscription]

Voorbeelden

Hiermee schakelt u de functie Clusterverbinding in.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect

Schakel de Azure RBAC-functie in.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features azure-rbac --skip-azure-rbac-list "user1@domain.com,spn_oid"

Meerdere functies inschakelen.

az connectedk8s enable-features -n clusterName -g resourceGroupName --features cluster-connect custom-locations

Vereiste parameters

--features

Door spaties gescheiden lijst met functies die u wilt inschakelen.

Eigenschap	Waarde
Geaccepteerde waarden:	azure-rbac, cluster-connect, custom-locations

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--custom-locations-oid

OID van de app 'custom-locations'.

--ids

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubconfig-context van de huidige computer.

--name -n

De naam van het verbonden cluster.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--skip-azure-rbac-list

Door komma's gescheiden lijst met namen van gebruikersnamen/e-mail/oid. Azure RBAC wordt overgeslagen voor deze gebruikers. Geef op wanneer u azure-rbac inschakelt.

Eigenschap	Waarde
Parametergroep:	Azure RBAC Arguments

--skip-ssl-verification

Sla SSL-verificatie over voor elke clusterverbinding.

Eigenschap	Waarde
Default value:	False

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedk8s list

Lijst met verbonden Kubernetes-clusters.

az connectedk8s list [--resource-group]

Voorbeelden

Vermeld alle verbonden Kubernetes-clusters in een resourcegroep.

az connectedk8s list -g resourceGroupName --subscription subscriptionName

Vermeld alle verbonden Kubernetes-clusters in een abonnement.

az connectedk8s list --subscription subscriptionName

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedk8s proxy

Toegang krijgen tot een verbonden Kubernetes-cluster.

az connectedk8s proxy [--file]
                      [--ids]
                      [--kube-context]
                      [--name]
                      [--port]
                      [--resource-group]
                      [--subscription]
                      [--token]

Voorbeelden

Toegang krijgen tot een verbonden Kubernetes-cluster.

az connectedk8s proxy -n clusterName -g resourceGroupName

Toegang krijgen tot een verbonden Kubernetes-cluster met aangepaste poort

az connectedk8s proxy -n clusterName -g resourceGroupName --port portValue

Toegang krijgen tot een verbonden Kubernetes-cluster met serviceaccounttoken

az connectedk8s proxy -n clusterName -g resourceGroupName --token tokenValue

Toegang krijgen tot een verbonden Kubernetes-cluster door een aangepaste kubeconfig-locatie op te geven

az connectedk8s proxy -n clusterName -g resourceGroupName -f path/to/kubeconfig

Toegang krijgen tot een verbonden Kubernetes-cluster door aangepaste context op te geven

az connectedk8s proxy -n clusterName -g resourceGroupName --kube-context contextName

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--file -f

Kubernetes-configuratiebestand dat moet worden bijgewerkt. Als dit niet is opgegeven, werkt u het bestand ~/.kube/config bij. Gebruik '-' om YAML in plaats daarvan af te drukken op stdout.

Eigenschap	Waarde
Default value:	~\.kube\config

--ids

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--kube-context

Als dit is opgegeven, overschrijft u de standaardcontextnaam.

--name -n

De naam van het verbonden cluster.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--port

Poort die wordt gebruikt voor toegang tot verbonden cluster.

Eigenschap	Waarde
Default value:	47011

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--token

Serviceaccounttoken dat moet worden gebruikt om te verifiëren bij het kubernetes-cluster.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedk8s show

Details van een verbonden kubernetes-cluster weergeven.

az connectedk8s show [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

Voorbeelden

De details voor een verbonden Kubernetes-cluster weergeven

az connectedk8s show -g resourceGroupName -n connectedClusterName

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--ids

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--name -n

De naam van het verbonden cluster.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedk8s troubleshoot

Preview

Deze opdracht is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Diagnostische controles uitvoeren op een Kubernetes-cluster met Arc.

az connectedk8s troubleshoot --name
                             --resource-group
                             [--kube-config]
                             [--kube-context]
                             [--skip-ssl-verification]
                             [--tags]

Voorbeelden

Diagnostische controles uitvoeren op een Kubernetes-cluster met Arc.

az connectedk8s troubleshoot -n clusterName -g resourceGroupName

Vereiste parameters

--name -n

De naam van het verbonden cluster.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubeconfig-context van de huidige computer.

--skip-ssl-verification

Sla SSL-verificatie over voor elke clusterverbinding.

Eigenschap	Waarde
Default value:	False

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedk8s update

Werk de eigenschappen van het kubernetes-cluster met arc-onboarding bij.

az connectedk8s update [--auto-upgrade {false, true}]
                       [--azure-hybrid-benefit {False, NotApplicable, True}]
                       [--config --configuration-settings]
                       [--config-protected --config-protected-settings]
                       [--container-log-path]
                       [--custom-ca-cert --proxy-cert]
                       [--disable-gateway {false, true}]
                       [--disable-proxy]
                       [--disable-wi --disable-workload-identity {false, true}]
                       [--distribution {aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg}]
                       [--distribution-version]
                       [--enable-oidc-issuer {false, true}]
                       [--enable-wi --enable-workload-identity {false, true}]
                       [--gateway-resource-id]
                       [--ids]
                       [--kube-config]
                       [--kube-context]
                       [--name]
                       [--proxy-http]
                       [--proxy-https]
                       [--proxy-skip-range]
                       [--resource-group]
                       [--self-hosted-issuer]
                       [--skip-ssl-verification]
                       [--subscription]
                       [--tags]
                       [--yes]

Voorbeelden

Proxywaarden voor de agents bijwerken

az connectedk8s update -g resourceGroupName -n connectedClusterName  --proxy-cert /path/to/crt --proxy-https https://proxy-url --proxy-http http://proxy-url --proxy-skip-range excludedIP,excludedCIDR,exampleCIDRfollowed,10.0.0.0/24

Proxy-instellingen voor agents uitschakelen

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-proxy

Automatische upgrade van agents uitschakelen

az connectedk8s update -g resourceGroupName -n connectedClusterName --auto-upgrade false

Werk een verbonden Kubernetes-cluster bij met oidc-verlener en de webhook voor de workloadidentiteit ingeschakeld.

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --enable-workload-identity

Werk een verbonden Kubernetes-cluster bij met oidc-verlener ingeschakeld met behulp van een zelf-hostende URL voor een openbaar cloudcluster.

az connectedk8s update -g resourceGroupName -n connectedClusterName --enable-oidc-issuer --self-hosted-issuer aksissuerurl

Schakel de webhook voor de workloadidentiteit uit op een verbonden Kubernetes-cluster.

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-workload-identity

Werk een verbonden Kubernetes-cluster bij met de functie Azure Gateway ingeschakeld.

az connectedk8s update -g resourceGroupName -n connectedClusterName --gateway-resource-id gatewayResourceId

Schakel de azure-gatewayfunctie uit op een verbonden Kubernetes-cluster.

az connectedk8s update -g resourceGroupName -n connectedClusterName --disable-gateway

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--auto-upgrade

Vlag om automatische upgrade van Arc-agents in of uit te schakelen. Standaard is automatische upgrade van agents ingeschakeld.

Eigenschap	Waarde
Geaccepteerde waarden:	false, true

--azure-hybrid-benefit

Vlag om de functie Azure Hybrid Benefit in of uit te schakelen.

Eigenschap	Waarde
Geaccepteerde waarden:	False, NotApplicable, True

--config --configuration-settings

Preview

Configuratie-instellingen als sleutel-waardepaar. Herhaal de parameter voor elke instelling. Gebruik dit niet voor geheimen, omdat deze waarde als antwoord wordt geretourneerd.

--config-protected --config-protected-settings

Preview

Met configuratie beveiligde instellingen als sleutel=waardepaar. Herhaal de parameter voor elke instelling. Alleen de sleutel wordt als antwoord geretourneerd, de waarde is niet.

--container-log-path

Overschrijf het standaardpad voor containerlogboeken om fluent-bit-logboekregistratie in te schakelen.

--custom-ca-cert --proxy-cert

Pad naar het certificaatbestand voor proxy of aangepaste certificeringsinstantie.

Eigenschap	Waarde
Parametergroep:	Proxy Arguments

--disable-gateway

Preview

Vlag om Arc Gateway uit te schakelen.

Eigenschap	Waarde
Parametergroep:	Gateway Arguments
Default value:	False
Geaccepteerde waarden:	false, true

--disable-proxy

Hiermee schakelt u proxy-instellingen voor agents uit.

Eigenschap	Waarde
Parametergroep:	Proxy Arguments
Default value:	False

--disable-wi --disable-workload-identity

Preview

Schakel de webhook voor workloadidentiteit uit.

Eigenschap	Waarde
Parametergroep:	Workload Identity Arguments
Geaccepteerde waarden:	false, true

--distribution

De Kubernetes-distributie die wordt uitgevoerd op dit verbonden cluster.

Eigenschap	Waarde
Geaccepteerde waarden:	aks, aks_edge_k3s, aks_edge_k8s, aks_engine, aks_management, aks_workload, canonical, capz, eks, generic, gke, k3s, karbon, kind, minikube, openshift, rancher_rke, tkg

--distribution-version

De Kubernetes-distributieversie van het verbonden cluster.

--enable-oidc-issuer

Preview

Schakel het maken van de OIDC-verlener-URL in die wordt gebruikt voor federatie van workloadidentiteit.

Eigenschap	Waarde
Parametergroep:	Workload Identity Arguments
Geaccepteerde waarden:	false, true

--enable-wi --enable-workload-identity

Preview

Schakel de webhook voor workloadidentiteit in.

Eigenschap	Waarde
Parametergroep:	Workload Identity Arguments
Geaccepteerde waarden:	false, true

--gateway-resource-id

Preview

ArmID van de Arc Gateway-resource.

Eigenschap	Waarde
Parametergroep:	Gateway Arguments

--ids

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubconfig-context van de huidige computer.

--name -n

De naam van het verbonden cluster.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--proxy-http

Http-proxy-URL die moet worden gebruikt.

Eigenschap	Waarde
Parametergroep:	Proxy Arguments

--proxy-https

Https-proxy-URL die moet worden gebruikt.

Eigenschap	Waarde
Parametergroep:	Proxy Arguments

--proxy-skip-range

Lijst met URL's/CIDR's waarvoor de proxy niet mag worden gebruikt.

Eigenschap	Waarde
Parametergroep:	Proxy Arguments

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--self-hosted-issuer

Preview

Zelf-hostende URL voor openbare cloudclusters - AKS, GKE, EKS.

Eigenschap	Waarde
Parametergroep:	Workload Identity Arguments

--skip-ssl-verification

Sla SSL-verificatie over voor elke clusterverbinding.

Eigenschap	Waarde
Default value:	False

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

--yes -y

Niet vragen om bevestiging.

Eigenschap	Waarde
Default value:	False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedk8s upgrade

Atomisch upgraden van onboarded agents naar de specifieke versie of standaard naar de nieuwste versie.

az connectedk8s upgrade [--agent-version]
                        [--ids]
                        [--kube-config]
                        [--kube-context]
                        [--name]
                        [--resource-group]
                        [--skip-ssl-verification]
                        [--subscription]
                        [--upgrade-timeout]

Voorbeelden

De agents upgraden naar de nieuwste versie

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName

De agents upgraden naar een specifieke versie

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --agent-version 0.2.62

Werk de agents bij met een aangepaste upgradetime-out.

az connectedk8s upgrade -g resourceGroupName -n connectedClusterName --upgrade-timeout 600

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--agent-version

Versie van de agent om de Helm-grafieken bij te werken.

--ids

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--kube-config

Pad naar het kube-configuratiebestand.

--kube-context

Kubconfig-context van de huidige computer.

--name -n

De naam van het verbonden cluster.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--skip-ssl-verification

Sla SSL-verificatie over voor elke clusterverbinding.

Eigenschap	Waarde
Default value:	False

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--upgrade-timeout

De benodigde tijd (in seconden) voor de arc-agent-pods die moeten worden geüpgraded op het kubernetes-cluster. Overschrijf deze waarde als de hardware-/netwerkbeperkingen voor uw cluster meer tijd nodig hebben voor het upgraden van de arc-agent pods.

Eigenschap	Waarde
Default value:	600

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

Feedback

Is deze pagina nuttig?

Delen via

az connectedk8s

Opdracht

az connectedk8s connect

Voorbeelden

Vereiste parameters

Optionele parameters

az connectedk8s delete

Voorbeelden

Optionele parameters

az connectedk8s disable-features

Voorbeelden

Vereiste parameters

Optionele parameters

az connectedk8s enable-features

Voorbeelden

Vereiste parameters

Optionele parameters

az connectedk8s list

Voorbeelden

Optionele parameters

az connectedk8s proxy

Voorbeelden

Optionele parameters

az connectedk8s show

Voorbeelden

Optionele parameters

az connectedk8s troubleshoot

Voorbeelden

Vereiste parameters

Optionele parameters

az connectedk8s update

Voorbeelden

Optionele parameters

az connectedk8s upgrade

Voorbeelden

Optionele parameters

Feedback