New-AzConnectedKubernetes
API voor het registreren van een nieuw Kubernetes-cluster en het maken van een bijgehouden resource in Azure Resource Manager (ARM).
Syntaxis
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>]
[-OidcIssuerProfileEnabled]
[-OidcIssuerProfileSelfHostedIssuerUrl <String>]
[-WorkloadIdentityEnabled]
[-AcceptEULA]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-ConfigurationSetting <Hashtable>]
[-ConfigurationProtectedSetting <Hashtable>]
[-GatewayResourceId <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
API voor het registreren van een nieuw Kubernetes-cluster en het maken van een bijgehouden resource in Azure Resource Manager (ARM).
Voorbeelden
Voorbeeld 1: Een verbonden kubernetes maken.
New-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -Location eastus
Location Name ResourceGroupName
-------- ---- -----------------
eastus azps_test_cluster azps_test_group
Met deze opdracht maakt u een verbonden kubernetes.
Voorbeeld 2: Maak een verbonden kubernetes met parameters kubeConfig en 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
Met deze opdracht maakt u een verbonden kubernetes met parameters kubeConfig en kubeContext.
Voorbeeld 3: Maak de AzureHybridBenefit van ConnectedKubernetes.
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
Maak de AzureHybridBenefit van ConnectedKubernetes.
Voorbeeld 4: Als u [-AcceptEULA] gebruikt, wordt standaard de acceptatie van de voorwaarden van onze juridische overeenkomst gebruikt en wordt er een verbonden kubernetes gemaakt.
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
Met [-AcceptEULA] wordt standaard de acceptatie van de voorwaarden van onze juridische overeenkomst geaccepteerd en wordt er een verbonden kubernetes gemaakt.
Voorbeeld 5: Maak een verbonden kubernetes met parameters HttpProxy, HttpsProxy, NoProxy en 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
Met deze opdracht maakt u een verbonden kubernetes met parameters HttpProxy, HttpsProxy, NoProxy en Proxy.
Voorbeeld 6: Maak een verbonden kubernetes met parameters HttpProxy, HttpsProxy, NoProxy, Proxy en ProxyCredential.
$pwd = ConvertTo-SecureString -String "****" -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
Met deze opdracht maakt u een verbonden kubernetes met parameters HttpProxy, HttpsProxy, NoProxy, Proxy en ProxyCredential.
Voorbeeld 7: Maak een verbonden kubernetes en schakel automatische upgrade van arc-agents uit.
New-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -Location eastus -DisableAutoUpgrade
Location Name ResourceGroupName
-------- ---- -----------------
eastus azps_test_cluster azps_test_group
Met deze opdracht maakt u een verbonden kubernetes en schakelt u automatische upgrade van arc-agents uit.
Voorbeeld 8: Een verbonden kubernetes maken met een aangepaste time-out voor onboarding.
New-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -Location eastus -OnboardingTimeout 600
Location Name ResourceGroupName
-------- ---- -----------------
eastus azps_test_cluster azps_test_group
Met deze opdracht maakt u een verbonden kubernetes met een aangepaste time-out voor onboarding.
Parameters
-AcceptEULA
Gebruiksrechtovereenkomst van ConnectedKubernetes accepteren, wordt er een juridische term weergegeven zonder deze parameter op te nemen
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-AsJob
De opdracht uitvoeren als een taak
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-AzureHybridBenefit
Geeft aan of Azure Hybrid Benefit is aangemeld
Type: | AzureHybridBenefit |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ClusterName
De naam van het Kubernetes-cluster waarop get wordt aangeroepen.
Type: | String |
Aliassen: | Name |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ConfigurationProtectedSetting
Arc Agentry System Protected Configuration (hash-tabel met hash-tabellen).
Type: | Hashtable |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ConfigurationSetting
Arc Agentry System Configuration (hash-tabel met hash-tabellen).
Type: | Hashtable |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Confirm
U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliassen: | cf |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ContainerLogPath
Overschrijf het standaardpad voor containerlogboeken om fluent-bit-logboekregistratie in te schakelen.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-CustomLocationsOid
OID van de app 'custom-locations'.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DefaultProfile
De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.
Type: | PSObject |
Aliassen: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DisableAutoUpgrade
Vlag om automatische upgrade van Arc-agents uit te schakelen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Distribution
De Kubernetes-distributie die wordt uitgevoerd op dit verbonden cluster.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DistributionVersion
De Kubernetes-distributieversie op dit verbonden cluster.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-GatewayResourceId
Resource-id van Arc Gateway
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-HttpProxy
De HTTP-URI van de proxyserver voor het kubernetes-cluster dat moet worden gebruikt
Type: | Uri |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-HttpsProxy
De https-URI van de proxyserver voor het kubernetes-cluster dat moet worden gebruikt
Type: | Uri |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Infrastructure
De infrastructuur waarop het Kubernetes-cluster dat wordt vertegenwoordigd door dit verbonden cluster, wordt uitgevoerd op.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-KubeConfig
Pad naar het kube-configuratiebestand
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-KubeContext
Kubconfig-context van de huidige machine
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Location
De geografische locatie waar de resource zich bevindt
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-NoProxy
De door komma's gescheiden lijst met hostnamen die moeten worden uitgesloten van de proxyserver voor het kubernetes-cluster dat moet worden gebruikt
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-NoWait
De opdracht asynchroon uitvoeren
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-OidcIssuerProfileEnabled
Of oidc-verlener moet worden ingeschakeld voor integratie van workloadidentiteiten.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-OidcIssuerProfileSelfHostedIssuerUrl
De URL van de uitgever voor openbare cloudclusters - AKS, EKS, GKE - die wordt gebruikt voor de functie voor workloadidentiteit.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-OnboardingTimeout
De benodigde tijd (in seconden) voor de arc-agent-pods die moeten worden geïnstalleerd op het kubernetes-cluster.
Type: | Int32 |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-PrivateLinkScopeResourceId
De resource-id van het private link-bereik waaraan dit verbonden cluster, indien van toepassing, is toegewezen.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-PrivateLinkState
Eigenschap die de status van een privékoppeling op een verbonden clusterresource beschrijft.
Type: | PrivateLinkState |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ProvisioningState
Inrichtingsstatus van de verbonden clusterresource.
Type: | ProvisioningState |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ProxyCert
Het pad naar het certificaatbestand voor proxy of aangepaste certificeringsinstantie.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ResourceGroupName
De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-SubscriptionId
De id van het doelabonnement.
Type: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Tag
Resourcetags.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-WhatIf
Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliassen: | wi |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-WorkloadIdentityEnabled
Of u de webhook voor de workloadidentiteit wilt in- of uitschakelen
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Uitvoerwaarden
Azure PowerShell