Azure-regisztráció ellenőrzéseValidate Azure registration

Az Azure Stack hub Readiness-ellenőrző eszköz (AzsReadinessChecker) használatával ellenőrizze, hogy az Azure-előfizetése készen áll-e a Azure stack hub használatára, mielőtt megkezdené az Azure stack hub központi telepítését.Use the Azure Stack Hub Readiness Checker tool (AzsReadinessChecker) to validate that your Azure subscription is ready to use with Azure Stack Hub before you begin an Azure Stack Hub deployment. A készültség-ellenőrző ellenőrzi, hogy:The readiness checker validates that:

  • A használt Azure-előfizetés támogatott típusú.The Azure subscription you use is a supported type. Az előfizetésnek felhőalapú megoldás-szolgáltatónak (CSP) vagy Nagyvállalati Szerződés (EA) kell lennie.Subscriptions must be a Cloud Solution Provider (CSP) or Enterprise Agreement (EA).
  • Az előfizetés az Azure-ban való regisztrálásához használt fiók bejelentkezhet az Azure-ba, és az előfizetés tulajdonosa.The account you use to register your subscription with Azure can sign in to Azure and is a subscription owner.

Az Azure Stack hub regisztrálásával kapcsolatos további információkért lásd: Azure stack hub regisztrálása az Azure-ban.For more information about Azure Stack Hub registration, see Register Azure Stack Hub with Azure.

A Readiness-ellenőrző eszköz beszerzéseGet the Readiness Checker tool

Töltse le a AzsReadinessChecker legújabb verzióját a PowerShell-Galéria.Download the latest version of AzsReadinessChecker from the PowerShell Gallery.

Telepítés és konfigurálásInstall and configure

ElőfeltételekPrerequisites

A következő előfeltételek szükségesek:The following prerequisites are required:

Az PowerShell-modulokAz PowerShell modules

Szüksége lesz az az PowerShell-modulok telepítésére.You will need to have the Az PowerShell modules installed. Útmutatásért lásd: a PowerShell telepítése az előnézet modul.For instructions, see Install PowerShell Az preview module.

Azure Active Directory (HRE) környezetAzure Active Directory (AAD) environment

  • Azonosítsa egy olyan fiók felhasználónevét és jelszavát, amely az Azure Stack hub-ban használni kívánt Azure-előfizetéshez tartozó tulajdonos.Identify the username and password for an account that's an owner for the Azure subscription you'll use with Azure Stack Hub.
  • Azonosítsa a használni kívánt Azure-előfizetés előfizetési AZONOSÍTÓját.Identify the subscription ID for the Azure subscription you'll use.

Az Azure-regisztráció érvényesítésének lépéseiSteps to validate the Azure registration

  1. Nyisson meg egy rendszergazda jogú PowerShell-parancssort, majd futtassa a következő parancsot a AzsReadinessChecker telepítéséhez:Open an elevated PowerShell prompt, and then run the following command to install AzsReadinessChecker:

    Install-Module -Name Az.BootStrapper -Force -AllowPrerelease
    Install-AzProfile -Profile 2019-03-01-hybrid -Force
    Install-Module -Name Microsoft.AzureStack.ReadinessChecker -AllowPrerelease
    
  2. A PowerShell-parancssorból futtassa a következő parancsot a használni kívánt Azure-előfizetés beállításához $subscriptionID .From the PowerShell prompt, run the following command to set $subscriptionID as the Azure subscription to use. Cserélje le xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx saját előfizetés-azonosítójával:Replace xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx with your own subscription ID:

    $subscriptionID = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    
  3. A PowerShell-parancssorból futtassa a következő parancsot:From the PowerShell prompt, run the following command:

    Connect-AzAccount -subscription $subscriptionID
    
  4. A PowerShell-parancssorból futtassa a következő parancsot az előfizetés érvényesítésének megkezdéséhez.From the PowerShell prompt, run the following command to start validation of your subscription. Adja meg az Azure AD-rendszergazdát és az Azure AD-bérlő nevét:Provide your Azure AD administrator and your Azure AD tenant name:

    Invoke-AzsRegistrationValidation  -RegistrationSubscriptionID $subscriptionID
    
  5. Az eszköz futtatása után tekintse át a kimenetet.After the tool runs, review the output. Ellenőrizze, hogy az állapot helyes-e a bejelentkezéshez és a regisztrációs követelményekhez.Confirm the status is correct for both sign-in and the registration requirements. A sikeres ellenőrzési kimenet a következő példához hasonlóan jelenik meg:Successful validation output appears similar to the following example:

    Invoke-AzsRegistrationValidation v1.2005.1269 started.
    Checking Registration Requirements: OK
    
    Log location (contains PII): C:\Users\[*redacted*]\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log
    Report location (contains PII): C:\Users\[*redacted*]\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
    Invoke-AzsRegistrationValidation Completed
    

Jelentés és naplófájlReport and log file

Minden alkalommal, amikor az érvényesítés lefut, az eredményeket a AzsReadinessChecker. log és aAzsReadinessCheckerReport.js bejegyzi.Each time validation runs, it logs results to AzsReadinessChecker.log and AzsReadinessCheckerReport.json. A fájlok helye a PowerShell érvényesítési eredményeivel együtt jelenik meg.The location of these files displays along with the validation results in PowerShell.

Ezek a fájlok segíthetnek az érvényesítési állapot megosztásában az Azure Stack hub üzembe helyezése vagy az érvényesítési problémák vizsgálata előtt.These files can help you share validation status before you deploy Azure Stack Hub or investigate validation problems. Mindkét fájl megőrzi az összes további érvényesítési ellenőrzés eredményét.Both files persist the results of each subsequent validation check. A jelentés az identitás konfigurációjának megerősítését biztosítja az üzembe helyezési csoport számára.The report provides your deployment team confirmation of the identity configuration. A naplófájl segítséget nyújthat az üzembe helyezéshez vagy a támogatási csoporthoz az érvényesítési problémák kivizsgálásához.The log file can help your deployment or support team investigate validation issues.

Alapértelmezés szerint mindkét fájl íródik a következőre: C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json .By default, both files are written to C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json.

  • A -OutputPath <path> futtatási parancssor végén található paraméterrel adhatja meg egy másik jelentés helyét.Use the -OutputPath <path> parameter at the end of the run command line to specify a different report location.
  • A -CleanReport futtatási parancs végén található paraméterrel törölheti az eszköz előző futtatásával kapcsolatos információkat a AzsReadinessCheckerReport.jsról.Use the -CleanReport parameter at the end of the run command to clear information about previous runs of the tool from AzsReadinessCheckerReport.json.

További információ: Azure stack hub-ellenőrzési jelentés.For more information, see Azure Stack Hub validation report.

Érvényesítési hibákValidation failures

Ha egy érvényesítési ellenőrzés sikertelen, a PowerShell-ablakban megjelenő hiba részletei láthatók.If a validation check fails, details about the failure display in the PowerShell window. Az eszköz az AzsReadinessChecker. log fájlba is naplózza az adatokat.The tool also logs information to the AzsReadinessChecker.log file.

Az alábbi példák a gyakori ellenőrzési hibákkal kapcsolatos további információkat tartalmazzák.The following examples provide more information about common validation failures.

A felhasználónak az előfizetés tulajdonosának kell lennieUser must be an owner of the subscription

Invoke-AzsRegistrationValidation v1.1809.1005.1 started.
Checking Registration Requirements: Fail
Error Details for registration account admin@contoso.onmicrosoft.com:
The user admin@contoso.onmicrosoft.com is role(s) Reader for subscription 3f961d1c-d1fb-40c3-99ba-44524b56df2d. User must be an owner of the subscription to be used for registration.
Additional help URL https://aka.ms/AzsRemediateRegistration

Log location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log
Report location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
Invoke-AzsRegistrationValidation Completed

OK – a fiók nem az Azure-előfizetés rendszergazdája.Cause - The account is not an administrator of the Azure subscription.

Megoldás – használjon olyan fiókot, amely az Azure-előfizetés rendszergazdája, amely az Azure stack hub üzembe helyezésével kapcsolatos díjat számít fel.Resolution - Use an account that is an administrator of the Azure subscription that will be billed for usage from the Azure Stack Hub deployment.

Lejárt vagy ideiglenes jelszóExpired or temporary password

Invoke-AzsRegistrationValidation v1.1809.1005.1 started.
Checking Registration Requirements: Fail
Error Details for registration account admin@contoso.onmicrosoft.com:
Checking Registration failed with: Retrieving TenantId for subscription [subscription ID] using account admin@contoso.onmicrosoft.com failed with AADSTS50055: Force Change Password.
Trace ID: [Trace ID]
Correlation ID: [Correlation ID]
Timestamp: 2018-10-22 11:16:56Z: The remote server returned an error: (401) Unauthorized.

Log location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log
Report location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
Invoke-AzsRegistrationValidation Completed

OK – a fiók nem tud bejelentkezni, mert a jelszó lejárt vagy ideiglenes.Cause - The account can't sign in because the password is either expired or temporary.

Megoldás – a PowerShellben futtassa a következő parancsot, és kövesse az utasításokat a jelszó alaphelyzetbe állításához.Resolution - In PowerShell, run the following command and follow the prompts to reset the password.

Login-AzureRMAccount

Egy másik lehetőség, hogy bejelentkezzen a Azure Portalba a fiók tulajdonosaként, és a felhasználó kénytelen lesz megváltoztatni a jelszót.Another way is to sign in to the Azure portal as the account owner, and the user will be forced to change the password.

Ismeretlen felhasználói típusUnknown user type

Invoke-AzsRegistrationValidation v1.1809.1005.1 started.
Checking Registration Requirements: Fail
Error Details for registration account admin@contoso.onmicrosoft.com:
Checking Registration failed with: Retrieving TenantId for subscription <subscription ID> using <account> failed with unknown_user_type: Unknown User Type

Log location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log
Report location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
Invoke-AzsRegistrationValidation Completed

OK – a fiók nem tud bejelentkezni a megadott Azure ad-környezetbe.Cause - The account can't sign in to the specified Azure AD environment. Ebben a példában a AzureChinaCloud a AzureEnvironment adja meg.In this example, AzureChinaCloud is specified as the AzureEnvironment.

Megoldás – ellenőrizze, hogy a fiók érvényes-e a megadott Azure-környezetben.Resolution - Confirm that the account is valid for the specified Azure environment. A PowerShellben futtassa a következő parancsot annak ellenőrzéséhez, hogy a fiók érvényes-e egy adott környezetben:In PowerShell, run the following command to verify the account is valid for a specific environment:

Login-AzureRmAccount -EnvironmentName AzureChinaCloud

További lépésekNext Steps