Dela via

Registrera tenanter för användningsspårning i Azure Stack Hub

  • Artikel

Den här artikeln innehåller information om registreringsåtgärder. Du kan använda dessa åtgärder för att:

  • Hantera klientregistreringar.
  • Hantera användningsspårning för hyresgäster.

Lägga till hyresgäst i registreringen

Du kan använda den här åtgärden när du vill lägga till en ny klientorganisation i din registrering. Klientanvändning rapporteras under en Azure-prenumeration som är ansluten till Microsoft Entra-klientorganisationen.

Du kan också använda den här åtgärden för att ändra prenumerationen som är associerad med en klientorganisation. Anropa PUT eller New-AzResource PowerShell-cmdlet för att skriva över den tidigare mappningen. Om du använder AzureRM PowerShell-modulen använder du New-AzureRMResource- PowerShell-cmdlet.

Du kan associera en enskild Azure-prenumeration med en klientorganisation. Om du försöker lägga till en andra prenumeration i en befintlig klientorganisation skrivs den första prenumerationen över.

Använda API-profiler

Följande registrerings-cmdletar kräver att du anger en API-profil när du kör PowerShell. API-profiler representerar en uppsättning Azure-resursprovidrar och deras API-versioner. De hjälper dig att använda rätt version av API:et när du interagerar med flera Azure-moln. Om du till exempel arbetar med flera moln när du arbetar med global Azure och Azure Stack Hub anger API-profiler ett namn som matchar deras utgivningsdatum. Du använder profilen 2017-09-03.

Mer information om Azure Stack Hub- och API-profiler finns i Hantera API-versionsprofiler i Azure Stack Hub.

Parametrar

Parameter Beskrivning
registrationSubscriptionID Den Azure-prenumeration som användes för den första registreringen.
kundprenumerations-ID Azure-prenumerationen (inte Azure Stack Hub) som tillhör kunden som ska registreras. Måste skapas i CSP-erbjudandet via Partner Center. Om en kund har fler än en klientorganisation skapar du en prenumeration för klientorganisationen för att logga in på Azure Stack Hub. Kundens prenumerations-ID är skiftlägeskänsligt.
resursgrupp Resursgruppen i Azure där registreringen lagras.
registreringsnamn Namnet på registreringen av din Azure Stack Hub. Det är ett objekt som lagras i Azure. Namnet är vanligtvis i formuläret azurestack-CloudID, där CloudID är moln-ID för din Azure Stack Hub-distribution.

Not

Klienter måste registreras med varje Azure Stack Hub-distribution som de använder. Om en klient använder mer än en Azure Stack Hub uppdaterar du de första registreringarna för varje distribution med klientprenumerationen.

PowerShell

Använd cmdleten New-AzResource för att lägga till en klientorganisation. Anslut till Azureoch kör därefter följande kommando från en prompt med administrativa rättigheter:

New-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01

API-anrop

Operation: PUT
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Svar: 201 Skapad
svarstext: Tom

Visa en lista över alla registrerade klienter

Hämta en lista över alla klienter som har lagts till i en registrering.

Obs

Om inga klienter har registrerats får du inget svar.

Parametrar

Parameter Beskrivning
registreringsabonnemangs-ID Den Azure-prenumeration som användes för den första registreringen.
resursgrupp Resursgruppen i Azure där registreringen lagras.
registreringsnamn Namnet på registreringen av din Azure Stack Hub-distribution. Det är ett objekt som lagras i Azure. Namnet är vanligtvis i form av azurestack-CloudID, där CloudID är moln-ID för din Azure Stack Hub-distribution.

PowerShell

Använd cmdleten Get-AzResource för att visa en lista över alla registrerade klienter. Anslut till Azure Stack Huboch kör därefter följande cmdlet från en administratörskommandotolk:

Get-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions" -ApiVersion 2017-06-01

API-anrop

Du kan hämta en lista över alla klientmappningar med hjälp av GET-åtgärden.

Åtgärd: GET
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
Svar: 200
Svarstext:

{
    "value": [{
            "id": " subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{ cspSubscriptionId 1}",
            "name": " cspSubscriptionId 1",
            "type": "Microsoft.AzureStack\customerSubscriptions",
            "properties": { "tenantId": "tId1" }
        },
        {
            "id": " subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{ cspSubscriptionId 2}",
            "name": " cspSubscriptionId2 ",
            "type": "Microsoft.AzureStack\customerSubscriptions",
            "properties": { "tenantId": "tId2" }
        }
    ],
    "nextLink": "{originalRequestUrl}?$skipToken={opaqueString}"
}

Ta bort en hyresgästkartläggning

Du kan ta bort en hyresgäst som har lagts till vid en registrering. Om klientorganisationen fortfarande använder resurser på Azure Stack Hub debiteras deras användning för den prenumeration som användes i den första Azure Stack Hub-registreringen.

Parametrar

Parameter Beskrivning
registreringsabonnemangs-ID Prenumerations-ID för registreringen.
resursgrupp Resursgruppen för registreringen.
registreringsNamn Namnet på registreringen.
kundabonnemangs-id Kundens prenumerations-ID. Kundens prenumerations-ID är skiftlägeskänsligt.

PowerShell

Använd cmdleten Remove-AzResource för att ta bort en hyresgäst. Anslut till Azure Stack Hub, och kör sedan följande cmdlet från en upphöjd kommandoprompt:

Remove-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01

API-anrop

Du kan ta bort klientmappningar med hjälp av åtgärden DELETE.

Åtgärd: DELETE
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Svar: 204 Inget innehåll
svarstext: Tom

Nästa steg