Disable-AksHciArcConnection
Synopsis
Disables Arc connection on an AKS hybrid cluster.
Syntax
Disable-AksHciArcConnection -name <String>
-tenantId <String>
-subscriptionId <String>
-resourceGroup <String>
-credential <PSCredential>
-location <String>
Description
Disables Arc connection on an AKS on an AKS hybrid cluster. This command does not delete any resources on the Azure Resource Manager. After running this command, make sure you go to the Azure portal to clean up any leftover resources.
Examples
Disconnect an AKS hybrid cluster to Azure Arc for Kubernetes using Azure user login
This command disconnects your workload cluster from Azure Arc using the subscription ID and resource group passed in the Set-AksHciRegistration
command while registering the AKS host for billing. Make sure that you have access to the subscription on an "Owner" role. You can check your access level by navigating to your subscription, clicking on "Access control (IAM)" on the left hand side of the Azure portal and then clicking on "View my access".
Connect-AzAccount
Disable-AksHciArcConnection -name "myCluster"
Disconnect an AKS on AKS hybrid cluster to Azure Arc for Kubernetes using a service principal
If you do not have access to a subscription on which you're an "Owner", you can disconnect your workload cluster from Azure Arc using a service principal.
The first command prompts for service principal credentials and stores them in the $Credential variable. Enter your application ID for the username and service principal secret as the password when prompted. Make sure you get these values from your subscription admin. The second command disconnects your cluster from Azure Arc using the service principal credentials stored in the $Credential variable.
$Credential = Get-Credential
Disable-AksHciArcConnection -name "myCluster" -subscriptionId "3000e2af-000-46d9-0000-4bdb12000000" -resourceGroup "myAzureResourceGroup" -credential $Credential -tenantId "xxxx-xxxx-xxxx-xxxx" -location "eastus"
Make sure the service principal used in the command above has the "Owner" or "Contributor" role assigned to it and that it has scope over the subscription ID and resource group used in the command. For more information on service principals, visit creating service principals with Azure PowerShell
Parameters
-Name
The alphanumeric name of your AKS cluster.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-tenantId
The tenant ID of your Azure service principal. Default value is the Azure login context. You can find out the default tenant ID using (Get-AzContext).Tenant.Id
command.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-subscriptionId
Your Azure account's subscription ID. Default value is the subscription ID passed in Set-AksHciRegistration
.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-resourceGroup
The name of the Azure resource group. Default value is the resource group passed in Set-AksHciRegistration
.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-credential
PSCredential for the Azure service principal.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-location
The location or Azure region of your Azure resource. Default value is the location passed in Set-AksHciRegistration
.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Azure resource group's location
Accept pipeline input: False
Accept wildcard characters: False