다음을 통해 공유

Azure 등록 유효성 검사

Azure Stack Hub 준비 검사 도구(AzsReadinessChecker)를 사용하여 Azure Stack Hub 배포를 시작하기 전에 Azure 구독이 Azure Stack Hub에서 사용할 준비가 됐음을 확인합니다. 준비 검사기는 다음의 유효성을 검사합니다.

  • 사용하는 Azure 구독은 지원되는 형식입니다. 구독은 CSP(클라우드 솔루션 공급자) 또는 EA(기업계약)여야 합니다.
  • Azure에 구독을 등록하는 데 사용하는 계정은 Azure에 로그인할 수 있으며 구독 소유자입니다.

Azure Stack Hub 등록에 관한 자세한 정보는 Azure Stack Hub를 Azure에 등록하기항목을 참조하세요.

준비 검사 도구 가져오기

최신 버전의 AzsReadinessChecker을 PowerShell 갤러리에서 다운로드합니다.

설치 및 구성

필수 구성 요소

다음 필수 구성 요소가 필요합니다.

Az PowerShell 모듈

Az PowerShell 모듈을 설치해야 합니다. 자세한 내용은 PowerShell Az 미리 보기 모듈설치를 참조하세요.

Microsoft Entra 환경

  • Azure Stack Hub에서 사용할 Azure 구독의 소유자인 계정의 사용자 이름 및 암호를 식별합니다.
  • 사용할 Azure 구독의 구독 ID를 식별합니다.

Azure 등록의 유효성을 검사하는 단계

  1. 관리자 권한 PowerShell 프롬프트를 열고 다음 명령을 실행하여 AzsReadinessChecker을 설치합니다:

    Install-Module -Name Az.BootStrapper -Force -AllowPrerelease
Install-AzProfile -Profile 2020-09-01-hybrid -Force
Install-Module -Name Microsoft.AzureStack.ReadinessChecker

  2. PowerShell 프롬프트에서 다음 명령을 실행하여 사용할 Azure 구독으로 $subscriptionID 설정합니다. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 사용자 고유의 구독 ID로 대체합니다.

    $subscriptionID = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

  3. PowerShell 프롬프트에서 다음 명령을 실행합니다.

    Connect-AzAccount -subscription $subscriptionID

  4. PowerShell 프롬프트에서 다음 명령을 실행하여 구독의 유효성 검사를 시작합니다. Microsoft Entra 관리자 및 Microsoft Entra 테넌트 이름을 제공합니다.

    Invoke-AzsRegistrationValidation  -RegistrationSubscriptionID $subscriptionID

  5. 도구가 실행된 후 출력을 검토합니다. 로그인 및 등록 요구 사항 모두에 대해 상태가 올바른지 확인합니다. 유효성 검사 출력이 성공하면 다음 예제와 유사하게 표시됩니다.

    Invoke-AzsRegistrationValidation v1.2100.1448.484 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

보고서 및 로그 파일

유효성 검사가 실행될 때마다 결과를 AzsReadinessChecker.log 및 AzsReadinessCheckerReport.json에 기록합니다. 이러한 파일의 위치는 PowerShell의 유효성 검사 결과와 함께 표시됩니다.

이러한 파일은 Azure Stack Hub를 배포하거나 유효성 검사 문제를 조사하기 전에 유효성 검사 상태를 공유하는 데 도움이 될 수 있습니다. 두 파일 모두 이후의 각 유효성 검사 결과를 유지합니다. 이 보고서는 배포 팀에게 ID 구성에 대한 확인을 제공합니다. 로그 파일은 배포 또는 지원 팀이 유효성 검사 문제를 조사하는 데 도움이 될 수 있습니다.

기본적으로 두 파일은 모두 C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json기록됩니다.

  • 실행 명령줄의 끝에 있는 -OutputPath <path> 매개 변수를 사용하여 다른 보고서 위치를 지정합니다.
  • 실행 명령의 끝에 있는 -CleanReport 매개 변수를 사용하여 AzsReadinessCheckerReport.json도구의 이전 실행에 대한 정보를 지울 수 있습니다.

자세한 내용은 Azure Stack Hub 유효성 검사 보고서 참조하세요.

유효성 검사 실패

유효성 검사에 실패하면 PowerShell 창에 오류에 대한 세부 정보가 표시됩니다. 또한 이 도구는 정보를 AzsReadinessChecker.log 파일에 기록합니다.

다음 예제에서는 일반적인 유효성 검사 실패에 대한 자세한 정보를 제공합니다.

사용자는 구독의 소유자여야 합니다.

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

원인 - 계정이 Azure 구독의 관리자가 아닙니다.

해결 - Azure Stack Hub 배포에서 사용 요금이 청구되는 Azure 구독의 관리자인 계정을 사용합니다.

만료되었거나 임시 암호

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

원인 - 암호가 만료되었거나 임시이므로 계정에 로그인할 수 없습니다.

해결 - PowerShell에서 다음 명령을 실행하고 프롬프트에 따라 암호를 재설정합니다.

Login-AzureRMAccount

또 다른 방법은 계정 소유자로 Azure Portal 로그인하는 것이며 사용자는 강제로 암호를 변경해야 합니다.

알 수 없는 사용자 유형

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

원인 - 계정이 지정된 Microsoft Entra 환경에 로그인할 수 없습니다. 이 예제에서 AzureChinaCloud는 AzureEnvironment로 지정됩니다.

해결 - 계정이 지정된 Azure 환경에 대해 유효한지 확인합니다. PowerShell에서 다음 명령을 실행하여 계정이 특정 환경에 유효한지 확인합니다.

Login-AzureRmAccount -EnvironmentName AzureChinaCloud

다음 단계

  • Last updated on