Konfigurera flera innehavare i Azure Stack Hub

Förutsättningar

Innan du registrerar eller avregistrerar en gästkatalog måste du och Mary utföra administrativa steg för dina respektive Microsoft Entra klienter: Azure Stack Hub-hemkatalogen (Contoso) och gästkatalogen (Adatum):

• Installera och konfigurera PowerShell för Azure Stack Hub.

• Ladda ned Azure Stack Hub Tools och importera sedan modulerna Anslut och identitet:

  Import-Module .\Identity\AzureStack.Identity.psm1
  

Registrera en gästkatalog

Om du vill registrera en gästkatalog för flera innehavare måste du konfigurera både Azure Stack Hub-hemkatalogen och gästkatalogen.

Konfigurera Azure Stack Hub-katalog

Som tjänstadministratör för contoso.onmicrosoft.com måste du först registrera Adatums gästkatalogklientorganisation till Azure Stack Hub. Följande skript konfigurerar Azure Resource Manager att acceptera inloggningar från användare och tjänstens huvudnamn i adatum.onmicrosoft.com klientorganisationen:

## The following Azure Resource Manager endpoint is for the ASDK. If you're in a multinode environment, contact your operator or service provider to get the endpoint, formatted as adminmanagement.<region>.<FQDN>.
$adminARMEndpoint = "https://adminmanagement.local.azurestack.external"

## Replace the value below with the Azure Stack Hub directory
$azureStackDirectoryTenant = "contoso.onmicrosoft.com"

## Replace the value below with the guest directory tenant. 
$guestDirectoryTenantToBeOnboarded = "adatum.onmicrosoft.com"

## Replace the value below with the name of the resource group in which the directory tenant registration resource should be created (resource group must already exist).
$ResourceGroupName = "system.local"

## Replace the value below with the region location of the resource group.
$location = "local"

# Subscription Name
$SubscriptionName = "Default Provider Subscription"

Register-AzSGuestDirectoryTenant -AdminResourceManagerEndpoint $adminARMEndpoint `
 -DirectoryTenantName $azureStackDirectoryTenant `
 -GuestDirectoryTenantName $guestDirectoryTenantToBeOnboarded `
 -Location $location `
 -ResourceGroupName $ResourceGroupName `
 -SubscriptionName $SubscriptionName

Konfigurera gästkatalog

Därefter måste Mary (katalogadministratör för Adatum) registrera Azure Stack Hub med adatum.onmicrosoft.com gästkatalog genom att köra följande skript:

## The following Azure Resource Manager endpoint is for the ASDK. If you're in a multinode environment, contact your operator or service provider to get the endpoint, formatted as management.<region>.<FQDN>.
$tenantARMEndpoint = "https://management.local.azurestack.external"

## Replace the value below with the guest directory tenant.
$guestDirectoryTenantName = "adatum.onmicrosoft.com"

Register-AzSWithMyDirectoryTenant `
 -TenantResourceManagerEndpoint $tenantARMEndpoint `
 -DirectoryTenantName $guestDirectoryTenantName `
 -Verbose

Uppmana användare att logga in

Slutligen kan Mary dirigera Adatum-användare med @adatum.onmicrosoft.com konton för att logga in genom att besöka Azure Stack Hub-användarportalen. För multinodsystem formateras användarportalens URL som https://portal.<region>.<FQDN>. För en ASDK-distribution är https://portal.local.azurestack.externalURL:en .

Mary måste också dirigera alla externa huvudkonton (användare i Adatum-katalogen utan suffixet adatum.onmicrosoft.com) för att logga in med .https://<user-portal-url>/adatum.onmicrosoft.com Om de inte anger katalogklientorganisationen /adatum.onmicrosoft.com i URL:en skickas de till standardkatalogen och får ett felmeddelande om att administratören inte har samtyckt.

Avregistrera en gästkatalog

Om du inte längre vill tillåta inloggningar till Azure Stack Hub-tjänster från en klientorganisation för gästkatalogen kan du avregistrera katalogen. Återigen måste både Azure Stack Hub-katalogen och gästkatalogen för hemmet konfigureras:

1. Som administratör för gästkatalogen (Mary i det här scenariot) kör du Unregister-AzsWithMyDirectoryTenant. Cmdleten avinstallerar alla Azure Stack Hub-appar från den nya katalogen.

   ## The following Azure Resource Manager endpoint is for the ASDK. If you're in a multinode environment, contact your operator or service provider to get the endpoint, formatted as management.<region>.<FQDN>.
   $tenantARMEndpoint = "https://management.local.azurestack.external"
   
   ## Replace the value below with the guest directory tenant.
   $guestDirectoryTenantName = "adatum.onmicrosoft.com"
   
   Unregister-AzsWithMyDirectoryTenant `
    -TenantResourceManagerEndpoint $tenantARMEndpoint `
    -DirectoryTenantName $guestDirectoryTenantName `
    -Verbose 
   

2. Som tjänstadministratör för Azure Stack Hub (du i det här scenariot) kör du cmdleten Unregister-AzSGuestDirectoryTenant :

   ## The following Azure Resource Manager endpoint is for the ASDK. If you're in a multinode environment, contact your operator or service provider to get the endpoint, formatted as adminmanagement.<region>.<FQDN>.
   $adminARMEndpoint = "https://adminmanagement.local.azurestack.external"
   
   ## Replace the value below with the Azure Stack Hub directory
   $azureStackDirectoryTenant = "contoso.onmicrosoft.com"
   
   ## Replace the value below with the guest directory tenant. 
   $guestDirectoryTenantToBeDecommissioned = "adatum.onmicrosoft.com"
   
   ## Replace the value below with the name of the resource group in which the directory tenant resource was created (resource group must already exist).
   $ResourceGroupName = "system.local"
   
   Unregister-AzSGuestDirectoryTenant -AdminResourceManagerEndpoint $adminARMEndpoint `
    -DirectoryTenantName $azureStackDirectoryTenant `
    -GuestDirectoryTenantName $guestDirectoryTenantToBeDecommissioned `
    -ResourceGroupName $ResourceGroupName
   

   Varning

   Stegen för att inaktivera flera innehavare måste utföras i ordning. Steg 1 misslyckas om steg 2 slutförs först.

Hämta hälsorapporten för Azure Stack Hub-identitet

<region>Ersätt platshållarna , <domain>och <homeDirectoryTenant> och kör sedan följande cmdlet som Azure Stack Hub-administratör.

$AdminResourceManagerEndpoint = "https://adminmanagement.<region>.<domain>"
$DirectoryName = "<homeDirectoryTenant>.onmicrosoft.com"
$healthReport = Get-AzsHealthReport -AdminResourceManagerEndpoint $AdminResourceManagerEndpoint -DirectoryTenantName $DirectoryName
Write-Host "Healthy directories: "
$healthReport.directoryTenants | Where status -EQ 'Healthy' | Select -Property tenantName,tenantId,status | ft


Write-Host "Unhealthy directories: "
$healthReport.directoryTenants | Where status -NE 'Healthy' | Select -Property tenantName,tenantId,status | ft

Uppdatera Microsoft Entra klientbehörigheter

Den här åtgärden rensar en avisering i Azure Stack Hub som anger att en katalog kräver en uppdatering. Kör följande kommando från mappen Azurestack-tools-master/identity :

Import-Module ..\Identity\AzureStack.Identity.psm1

$adminResourceManagerEndpoint = "https://adminmanagement.<region>.<domain>"

# This is the primary tenant Azure Stack Hub is registered to:
$homeDirectoryTenantName = "<homeDirectoryTenant>.onmicrosoft.com"

Update-AzsHomeDirectoryTenant -AdminResourceManagerEndpoint $adminResourceManagerEndpoint `
   -DirectoryTenantName $homeDirectoryTenantName -Verbose

Skriptet uppmanar dig att ange administrativa autentiseringsuppgifter för den Microsoft Entra klientorganisationen och det tar flera minuter att köra. Aviseringen rensas när du har kört cmdleten.