New-AzConnectedKubernetes
새 Kubernetes 클러스터를 등록하고 ARM(Azure Resource Manager)에서 추적된 리소스를 만드는 API입니다.
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>]
Description
새 Kubernetes 클러스터를 등록하고 ARM(Azure Resource Manager)에서 추적된 리소스를 만드는 API입니다.
예제
예제 1: 연결된 kubernetes를 만듭니다.
New-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -Location eastus
Location Name ResourceGroupName
-------- ---- -----------------
eastus azps_test_cluster azps_test_group
이 명령은 연결된 kubernetes를 만듭니다.
예제 2: kubeConfig 및 kubeContext 매개 변수를 사용하여 연결된 kubernetes를 만듭니다.
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
이 명령은 kubeConfig 및 kubeContext 매개 변수를 사용하여 연결된 kubernetes를 만듭니다.
예제 3: 커넥트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
커넥트edKubernetes의 AzureHybridBenefit을 만듭니다.
예제 4: [-AcceptEULA]를 사용하면 기본적으로 법적 계약 조건에 동의하고 연결된 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
[-AcceptEULA]를 사용하면 기본적으로 법적 계약 조건에 동의하고 연결된 kubernetes를 만듭니다.
예제 5: HttpProxy, HttpsProxy, NoProxy 및 프록시 매개 변수를 사용하여 연결된 kubernetes를 만듭니다.
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
이 명령은 HttpProxy, HttpsProxy, NoProxy 및 프록시 매개 변수를 사용하여 연결된 kubernetes를 만듭니다.
예제 6: HttpProxy, HttpsProxy, NoProxy, Proxy 및 ProxyCredential 매개 변수를 사용하여 연결된 kubernetes를 만듭니다.
$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
이 명령은 HttpProxy, HttpsProxy, NoProxy, Proxy 및 ProxyCredential 매개 변수를 사용하여 연결된 kubernetes를 만듭니다.
예제 7: 연결된 kubernetes를 만들고 arc 에이전트의 자동 업그레이드를 사용하지 않도록 설정합니다.
New-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -Location eastus -DisableAutoUpgrade
Location Name ResourceGroupName
-------- ---- -----------------
eastus azps_test_cluster azps_test_group
이 명령은 연결된 kubernetes를 만들고 arc 에이전트의 자동 업그레이드를 사용하지 않도록 설정합니다.
예제 8: 사용자 지정 온보딩 시간 제한을 사용하여 연결된 kubernetes를 만듭니다.
New-AzConnectedKubernetes -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -Location eastus -OnboardingTimeout 600
Location Name ResourceGroupName
-------- ---- -----------------
eastus azps_test_cluster azps_test_group
이 명령은 사용자 지정 온보딩 시간 제한을 사용하여 연결된 kubernetes를 만듭니다.
매개 변수
-AcceptEULA
커넥트edKubernetes의 EULA를 수락하면 이 매개 변수가 제공되지 않으면 법적 용어가 표시됩니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsJob
작업으로 명령 실행
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AzureHybridBenefit
Azure 하이브리드 혜택 옵트인되는지 여부를 나타냅니다.
Type: | AzureHybridBenefit |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClusterName
가져오기가 호출되는 Kubernetes 클러스터의 이름입니다.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContainerLogPath
흐름 비트 로깅을 사용하도록 설정하려면 기본 컨테이너 로그 경로를 재정의합니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomLocationsOid
'사용자 지정 위치' 앱의 OID입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
Type: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableAutoUpgrade
Arc 에이전트의 자동 업그레이드를 사용하지 않도록 설정하는 플래그입니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Distribution
연결된 클러스터에서 실행되는 Kubernetes 배포입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionVersion
연결된 클러스터의 Kubernetes 배포 버전입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HttpProxy
사용할 kubernetes 클러스터에 대한 프록시 서버의 http URI
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HttpsProxy
사용할 kubernetes 클러스터에 대한 프록시 서버의 https URI
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Infrastructure
연결된 클러스터가 나타내는 Kubernetes 클러스터가 실행되는 인프라입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KubeConfig
kube 구성 파일의 경로
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KubeContext
현재 컴퓨터의 Kubconfig 컨텍스트
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
리소스가 있는 지리적 위치
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoProxy
kubernetes 클러스터에서 사용할 프록시 서버에서 제외해야 하는 쉼표로 구분된 호스트 이름 목록
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoWait
명령을 비동기적으로 실행
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnboardingTimeout
arc-agent Pod를 kubernetes 클러스터에 설치하는 데 필요한 시간(초)입니다.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateLinkScopeResourceId
연결된 클러스터가 할당된 프라이빗 링크 범위의 리소스 ID(있는 경우)입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateLinkState
연결된 클러스터 리소스의 프라이빗 링크 상태를 설명하는 속성입니다.
Type: | PrivateLinkState |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProvisioningState
연결된 클러스터 리소스의 프로비전 상태입니다.
Type: | ProvisioningState |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyCert
프록시 또는 사용자 지정 인증 기관에 대한 인증서 파일의 경로입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
대상 구독의 ID입니다.
Type: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
리소스 태그.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
출력
Azure PowerShell
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기