Limpar os dados do utilizador do portal a partir do Azure Stack HubClear portal user data from Azure Stack Hub

Os operadores do Azure Stack Hub podem limpar os dados do utilizador do portal sobre a procura quando os utilizadores do Azure Stack Hub o solicitarem.Azure Stack Hub operators can clear portal user data on demand when Azure Stack Hub users request it. Como utilizador do Azure Stack Hub, o portal pode ser personalizado fixando azulejos e alterando o layout do painel de instrumentos.As an Azure Stack Hub user, the portal can be customized by pinning tiles and changing the dashboard layout. Os utilizadores também podem alterar o tema e ajustar o idioma predefinido para corresponder às preferências pessoais.Users can also change the theme and adjust the default language to match personal preferences.

Os dados dos utilizadores do portal incluem os favoritos e os recursos recentemente acedidos no portal de utilizadores do Azure Stack Hub.Portal user data includes favorites and recently accessed resources in the Azure Stack Hub user portal. Este artigo descreve como limpar os dados do portal do utilizador.This article describes how to clear the portal user data.

A remoção das definições do utilizador do portal só deve ser feita depois de a subscrição do utilizador ter sido eliminada.Removing portal user settings should only be done after the user subscription has been deleted.

Nota

Alguns dados do utilizador ainda podem existir na secção do sistema de registos de eventos depois de seguir as orientações deste artigo.Some user data can still exist in the system section of event logs after following the guidance in this article. Estes dados podem permanecer durante vários dias até que os registos rebolam automaticamente.This data can remain for several days until the logs automatically roll over.

RequisitosRequirements

Nota

Se tentar eliminar informações do utilizador do portal de um utilizador que foi convidado a partir de um diretório de hóspedes (multi-arrendamento), deve ter lido permissão nesse diretório.If you attempt to delete portal user information from a user that was invited from a guest directory (multi-tenancy), you must have read permission in that directory. Para mais informações, consulte o cenário do PCP mais tarde neste artigo.For more information, see the CSP scenario later in this article.

Limpar os dados do utilizador do portal usando o nome principal do utilizadorClear portal user data using a user principal name

Este cenário pressupõe que a subscrição do fornecedor predefinido e o utilizador fazem parte do mesmo diretório, ou que leu o acesso ao diretório em que o utilizador reside.This scenario assumes that either the default provider subscription and the user are part of the same directory, or that you have read access to the directory in which the user resides.

Certifique-se de baixar a versão mais recente das ferramentas Azure Stack Hub do GitHub antes de prosseguir.Make sure to download the latest version of the Azure Stack Hub tools from GitHub before you proceed.

Para este procedimento, utilize um computador que possa comunicar com o ponto final do Azure Stack Hub.For this procedure, use a computer that can communicate with the admin Resource Manager endpoint of Azure Stack Hub.

  1. Abra uma sessão elevada do Windows PowerShell (executada como administrador), vá à pasta raiz no diretório AzureStack-Tools-az e importe o módulo PowerShell necessário:Open an elevated Windows PowerShell session (run as administrator), go to the root folder in the AzureStack-Tools-az directory, and import the required PowerShell module:

    Import-Module .\DatacenterIntegration\Portal\PortalUserDataUtilities.psm1
    
  2. Execute os seguintes comandos.Run the following commands. Certifique-se de substituir os espaços reservados por valores que correspondam ao seu ambiente:Make sure to substitute the placeholders with values that match your environment:

    ## 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
    

    Nota

    azureStackDirectoryTenantId é opcional.azureStackDirectoryTenantId is optional. Se não especificar este valor, o script procura o nome principal do utilizador em todos os diretórios de inquilinos registados no Azure Stack Hub e, em seguida, limpa os dados do portal para todos os utilizadores correspondentes.If you don't specify this value, the script searches for the user principal name in all tenant directories registered in Azure Stack Hub and then clears the portal data for all matched users.

Limpar os dados do utilizador do portal no diretório de hóspedesClear portal user data in guest directory

Neste cenário, o operador Azure Stack Hub não tem acesso ao diretório de hóspedes em que o utilizador reside.In this scenario, the Azure Stack Hub operator has no access to the guest directory in which the user resides. Este é um cenário comum quando se é um Fornecedor de Soluções cloud (CSP).This is a common scenario when you're a Cloud Solution Provider (CSP).

Para que um operador do Azure Stack Hub remova os dados do utilizador do portal, é necessário, no mínimo, o ID do objeto do utilizador.For an Azure Stack Hub operator to remove the portal user data, at a minimum the user object ID is required.

O utilizador deve consultar o ID do objeto e forneci-lo ao operador Azure Stack Hub.The user must query the object ID and provide it to the Azure Stack Hub operator. O operador não tem acesso ao diretório em que o utilizador reside.The operator doesn't have access to the directory in which the user resides.

O utilizador recupera o ID do objeto do utilizadorUser retrieves the user object ID

  1. Abra uma sessão elevada do Windows PowerShell (executada como administrador), vá à pasta raiz no diretório AzureStack-Tools-az e, em seguida, importe o módulo PowerShell necessário.Open an elevated Windows PowerShell session (run as administrator), go to the root folder in the AzureStack-Tools-az directory, and then import the necessary PowerShell module.

    Import-Module .\DatacenterIntegration\Portal\PortalUserDataUtilities.psm1
    
  2. Execute os seguintes comandos.Run the following commands. Certifique-se de substituir os espaços reservados por valores que correspondam ao seu ambiente.Make sure to substitute the placeholders with values that match your environment.

    ## 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
    

    Nota

    Como utilizador, deve fornecer o ID do objeto do utilizador, que é a saída do script anterior, ao operador Azure Stack Hub.As a user, you must provide the user object ID, which is the output of the previous script, to the Azure Stack Hub operator.

O operador do Azure Stack Hub remove os dados do utilizador do portalAzure Stack Hub operator removes the portal user data

Depois de receber o ID do objeto do utilizador como operador do Azure Stack Hub, execute os seguintes comandos para remover os dados do utilizador do portal:After receiving the user object ID as an Azure Stack Hub operator, run the following commands to remove the portal user data:

  1. Abra uma sessão elevada do Windows PowerShell (executada como administrador), vá à pasta raiz no diretório AzureStack-Tools-az e, em seguida, importe o módulo PowerShell necessário.Open an elevated Windows PowerShell session (run as administrator), go to the root folder in the AzureStack-Tools-az directory, and then import the necessary PowerShell module.

    Import-Module .\DatacenterIntegration\Portal\PortalUserDataUtilities.psm1
    
  2. Executar os seguintes comandos, certificando-se de que ajusta o parâmetro para corresponder ao seu ambiente:Run the following commands, making sure you adjust the parameter to match your environment:

    ## 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 `
    

Passos seguintesNext steps