Limpar dados de utilizador do portal a partir do Azure Stack Hub

  • Artigo

Os operadores do Azure Stack Hub podem limpar os dados de utilizador do portal a pedido quando os utilizadores do Azure Stack Hub os pedirem. Enquanto utilizador do Azure Stack Hub, o portal pode ser personalizado ao afixar mosaicos e alterar o esquema do dashboard. Os utilizadores também podem alterar o tema e ajustar o idioma predefinido para corresponder às preferências pessoais.

Os dados de utilizador do portal incluem favoritos e recursos acedidos recentemente no portal de utilizadores do Azure Stack Hub. Este artigo descreve como limpar os dados de utilizador do portal.

A remoção das definições de utilizador do portal só deve ser efetuada depois de a subscrição do utilizador ter sido eliminada.

Nota

Alguns dados de utilizador ainda podem existir na secção de sistema dos registos de eventos depois de seguir a documentação de orientação neste artigo. Estes dados podem permanecer durante vários dias até que os registos sejam revertidos automaticamente.

Pré-requisitos

Nota

Se tentar eliminar as informações de utilizador do portal de um utilizador que foi convidado de um diretório convidado (multi-inquilino), tem de ter permissão de leitura nesse diretório. Para obter mais informações, veja o cenário CSP mais adiante neste artigo.

Limpar dados de utilizador do portal com um nome principal de utilizador

Este cenário pressupõe que a subscrição de fornecedor predefinida e o utilizador fazem parte do mesmo diretório ou que tem acesso de leitura ao diretório no qual o utilizador reside.

Antes de continuar, certifique-se de que transfere a versão mais recente das ferramentas do Azure Stack Hub a partir do GitHub.

Para este procedimento, utilize um computador que possa comunicar com o administrador Resource Manager ponto final do Azure Stack Hub.

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

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

  2. Execute os seguintes comandos. Certifique-se de que substitui os marcadores de posição pelos valores que correspondem 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

    Nota

    azureStackDirectoryTenantId é opcional. Se não especificar este valor, o script procura o nome principal de utilizador em todos os diretórios inquilinos registados no Azure Stack Hub e, em seguida, limpa os dados do portal para todos os utilizadores correspondentes.

Limpar dados de utilizador do portal no diretório convidado

Neste cenário, o operador do Azure Stack Hub não tem acesso ao diretório convidado no qual o utilizador reside. Este é um cenário comum quando se é um Fornecedor de Soluções Cloud (CSP).

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

O utilizador tem de consultar o ID do objeto e disponibilizá-lo ao operador do Azure Stack Hub. O operador não tem acesso ao diretório no qual o utilizador reside.

O utilizador obtém o ID do objeto de utilizador

  1. Abra uma sessão de Windows PowerShell elevada (executar como administrador), aceda à pasta raiz no diretório AzureStack-Tools-az e, em seguida, importe o módulo do PowerShell necessário.

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

  2. Execute os seguintes comandos. Certifique-se de que substitui os marcadores de posição pelos valores que correspondem 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

    Nota

    Enquanto utilizador, tem de fornecer o ID do objeto de utilizador, que é o resultado do script anterior, ao operador do Azure Stack Hub.

Operador do Azure Stack Hub remove os dados de utilizador do portal

Depois de receber o ID do objeto de utilizador como um operador do Azure Stack Hub, execute os seguintes comandos para remover os dados de utilizador do portal:

  1. Abra uma sessão de Windows PowerShell elevada (executar como administrador), aceda à pasta raiz no diretório AzureStack-Tools-az e, em seguida, importe o módulo do PowerShell necessário.

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

  2. Execute os seguintes comandos, certificando-se de que ajusta 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 `

Passos seguintes