Limpar dados de usuário do portal do Azure Stack Hub

Os operadores do Azure Stack Hub podem limpar os dados do usuário do portal sob demanda quando os usuários do Azure Stack Hub solicitarem. Como um usuário do Azure Stack Hub, o portal pode ser personalizado fixando blocos e alterando o layout do painel. Os usuários também podem alterar o tema e ajustar o idioma padrão para corresponder às preferências pessoais.

Os dados do usuário do portal incluem favoritos e recursos acessados recentemente no portal do usuário do Azure Stack Hub. Este artigo descreve como limpar os dados do usuário do portal.

A remoção das configurações do usuário do portal só deve ser feita depois que a assinatura do usuário tiver sido excluída.

Pré-requisitos

• Instale o PowerShell para Azure Stack Hub.
• Baixe as ferramentas mais recentes do Azure Stack Hub do GitHub.
• A conta de usuário ainda deve existir no diretório.
• Credenciais de administrador do Azure Stack Hub para aceder ao ponto de extremidade de administrador do Resource Manager.

Limpar dados de usuário do portal usando um nome principal de usuário

Esse cenário pressupõe que a assinatura do provedor padrão e o usuário façam parte do mesmo diretório ou que você tenha acesso de leitura ao diretório no qual o usuário reside.

Certifique-se de baixar a versão mais recente das ferramentas do Azure Stack Hub do GitHub antes de continuar.

Para este procedimento, use um computador que possa se comunicar com o ponto de extremidade administrador do Gerenciador de Recursos do Azure Stack Hub.

1. Abra uma sessão elevada do Windows PowerShell (execute como administrador), vá para a pasta raiz no diretório AzureStack-Tools-az e importe o módulo PowerShell necessário:

   Import-Module .\DatacenterIntegration\Portal\PortalUserDataUtilities.psm1
   

2. Execute os seguintes comandos. Certifique-se de substituir os espaços reservados por valores que correspondam ao seu ambiente:

   ## The following Azure Resource Manager endpoint is for the ASDK. If you are in a multinode environment, contact your operator or service provider to get the endpoint.
   
   $adminARMEndpoint = "https://adminmanagement.local.azurestack.external"
   
   ## Replace the following value with the Azure Stack Hub directory tenant ID.
   $azureStackDirectoryTenantId = "f5025bf2-547f-4b49-9693-6420c1d5e4ca"
   
   ## Replace the following value with the user directory tenant ID.
   $userDirectoryTenantId = " 7ddf3648-9671-47fd-b63d-eecd82ed040e"
   
   ## Replace the following value with name of the user principal whose portal user data is to be cleared.
   $userPrincipalName = "myaccount@contoso.onmicrosoft.com"
   
   Clear-AzsUserDataWithUserPrincipalName -AzsAdminArmEndpoint $adminARMEndpoint `
    -AzsAdminDirectoryTenantId $azureStackDirectoryTenantId `
    -UserPrincipalName $userPrincipalName `
    -DirectoryTenantId $userDirectoryTenantId
   

   Observação

   azureStackDirectoryTenantId é opcional. Se você não especificar esse valor, o script procurará o nome principal do usuário em todos os diretórios de locatário registrados no Azure Stack Hub e, em seguida, limpará os dados do portal para todos os usuários correspondentes.

Limpar dados do usuário do portal no diretório convidado

Nesse cenário, o operador do Azure Stack Hub não tem acesso ao diretório convidado no qual o usuário reside. Este é um cenário comum quando você é um Provedor de Soluções na Nuvem (CSP).

Para que um operador do Azure Stack Hub remova os dados do usuário do portal, no mínimo, a ID do objeto do usuário é necessária.

O usuário deve consultar a ID do objeto e fornecê-la ao operador do Azure Stack Hub. O operador não tem acesso ao diretório no qual o usuário reside.

O usuário recupera o ID do objeto do usuário

1. Abra uma sessão elevada do Windows PowerShell (execute como administrador), vá para a pasta raiz no diretório AzureStack-Tools-az e importe o módulo PowerShell necessário.

   Import-Module .\DatacenterIntegration\Portal\PortalUserDataUtilities.psm1
   

2. Execute os seguintes comandos. Certifique-se de substituir os espaços reservados por valores que correspondam ao seu ambiente.

   ## The following Azure Resource Manager endpoint is for the ASDK. If you are in a multinode environment, contact your operator or service provider to get the endpoint.
   $userARMEndpoint = "https://management.local.azurestack.external"
   
   ## Replace the following value with the directory tenant ID, which contains the user account.
   $userDirectoryTenantId = "3160cbf5-c227-49dd-8654-86e924c0b72f"
   
   ## Replace the following value with the name of the user principal whose portal user data is to be cleared.
   $userPrincipleName = "myaccount@contoso.onmicrosoft.com"
   
   Get-UserObjectId -DirectoryTenantId $userDirectoryTenantId `
    -AzsArmEndpoint $userARMEndpoint `
    -UserPricinpalName $userPrincipleName
   

   Observação

   Como usuário, você deve fornecer a ID do objeto de usuário, que é a saída do script anterior, para o operador do Azure Stack Hub.

O operador do Azure Stack Hub remove os dados do usuário do portal

Depois de receber a ID do objeto de usuário como um operador do Azure Stack Hub, execute os seguintes comandos para remover os dados do usuário do portal:

1. Abra uma sessão elevada do Windows PowerShell (execute como administrador), vá para a pasta raiz no diretório AzureStack-Tools-az e importe o módulo PowerShell necessário.

   Import-Module .\DatacenterIntegration\Portal\PortalUserDataUtilities.psm1
   

2. Execute os seguintes comandos, certificando-se de ajustar o parâmetro para corresponder ao seu ambiente:

   ## The following Azure Resource Manager endpoint is for the ASDK. If you are in a multinode environment, contact your operator or service provider to get the endpoint.
   $AzsAdminARMEndpoint = "https://adminmanagement.local.azurestack.external"
   
   ## Replace the following value with the Azure Stack Hub directory tenant ID.
   $AzsAdminDirectoryTenantId = "f5025bf2-547f-4b49-9693-6420c1d5e4ca"
   
   ## Replace the following value with the directory tenant ID of the user to clear.
   $DirectoryTenantId = "3160cbf5-c227-49dd-8654-86e924c0b72f"
   
   ## Replace the following value with the name of the user principal whose portal user data is to be cleared.
   $userObjectID = "s-1-*******"
   Clear-AzsUserDataWithUserObject -AzsAdminArmEndpoint $AzsAdminARMEndpoint `
    -AzsAdminDirectoryTenantId $AzsAdminDirectoryTenantId `
    -DirectoryTenantID $DirectoryTenantId `
    -UserObjectID $userObjectID `
   

Próximos passos

• Registre o Azure Stack Hub com o Azure e preencha o Azure Stack Hub Marketplace com itens para oferecer aos seus usuários.