Edit

Disable-AksHciArcConnection

  • Article

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

Next steps

AksHci PowerShell Reference