ASDK 的部署后配置

安装 Azure Stack 开发工具包 (ASDK) 之后,当你在 ASDK 主计算机上以 AzureStack\AzureStackAdmin 身份登录时,应进行一些建议的部署后配置更改。

安装 Azure Stack PowerShell

需要安装与 Azure Stack 兼容的 Azure PowerShell 模块才能使用 Azure Stack。

通过 PowerShell 库安装适用于 Azure Stack 的 PowerShell 命令。 若要注册 PSGallery 存储库,请打开权限提升的 PowerShell 会话并运行以下命令:

Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted

使用 API 版本配置文件来指定与 Azure Stack 兼容的 Az 模块。 API 版本配置文件提供一种管理 Azure 与 Azure Stack 之间版本差异的方式。 API 版本配置文件是一组具有特定 API 版本的 Az PowerShell 模块。 可通过 PowerShell 库获得的 Az.BootStrapper 模块会提供使用 API 版本配置文件所需的 PowerShell cmdlet。

无论是否与 ASDK 主机建立了 Internet 连接,都可以安装最新的 Azure Stack PowerShell 模块。

  1. 在 Windows 计算机上验证先决条件。 有关说明,请参阅 Windows 先决条件
  2. 在安装所需 PowerShell 版本之前,请务必卸载任何现有的 Azure PowerShell 模块
  • 已从 ASDK 主计算机建立 Internet 连接:运行以下 PowerShell 脚本,以在 ASDK 安装中安装以下模块:
  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

  Install-Module -Name Az.BootStrapper -Force
  Install-AzProfile -Profile 2020-09-01-hybrid -Force
  Install-Module -Name AzureStack -RequiredVersion 2.1.0

  Get-Module -Name "Az*" -ListAvailable
  Get-Module -Name "Azs*" -ListAvailable

如果安装成功,输出中会显示 Az 和 AzureStack 模块。

  • 未从 ASDK 主计算机建立 Internet 连接:在离线场景中,必须先使用以下 PowerShell 命令,将 PowerShell 模块下载到已建立 Internet 连接的计算机:
$Path = "<Path that is used to save the packages>"

Save-Package `
  -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name Az -Path $Path -Force -RequiredVersion 1.10.0

Save-Package `
  -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 2.1.0

接下来,将下载的包复制到 ASDK 计算机,将该位置注册为默认存储库,并从此存储库安装 Az 和 AzureStack 模块:

$SourceLocation = "<Location on the development kit that contains the PowerShell packages>"
$RepoName = "MyNuGetSource"

Register-PSRepository -Name $RepoName -SourceLocation $SourceLocation -InstallationPolicy Trusted

Install-Module Az -Repository $RepoName

Install-Module AzureStack -Repository $RepoName

下载 Azure Stack 工具

AzureStack-Tools 是托管 PowerShell 模块的 GitHub 存储库,可用于管理资源并将其部署到 Azure Stack。 可通过 Az PowerShell 模块或 AzureRM 模块来使用这些工具。

若要获取这些工具,请从 az 分支克隆 GitHub 存储库,或运行以下脚本来下载 AzureStack-Tools 文件夹:

# Change directory to the root directory.
cd \

# Download the tools archive.
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 
invoke-webrequest `
  https://github.com/Azure/AzureStack-Tools/archive/az.zip `
  -OutFile az.zip

# Expand the downloaded files.
expand-archive az.zip `
  -DestinationPath . `
  -Force

# Change to the tools directory.
cd AzureStack-Tools-az

验证 ASDK 安装

若要确保 ASDK 部署成功,可以遵循以下步骤使用 Test-AzureStack cmdlet:

  1. 以 AzureStack\AzureStackAdmin 身份登录到 ASDK 主计算机。
  2. 以管理员身份打开 PowerShell(非 PowerShell ISE)。
  3. 运行: Enter-PSSession -ComputerName AzS-ERCS01 -ConfigurationName PrivilegedEndpoint
  4. 运行: Test-AzureStack

此项测试可能需要几分钟时间才能完成。 如果安装成功,将返回如下所示的输出:

Test Azure Stack - Installation successful

如果失败,请遵循故障排除步骤来获取帮助。

启用多租户

对于使用 Microsoft Entra ID 的部署,需要为 ASDK 安装启用多租户

注意

当使用非用于注册 Azure Stack 的域的管理员或用户帐户登录 Azure Stack 门户时,用于注册 Azure Stack 的域名必须追加到门户 URL 后面。 例如,如果 Azure Stack 已注册到 fabrikam.partner.onmschina.cn 并且登录的用户帐户为 admin@contoso.com,则用于登录用户门户的 URL 将为:https://portal.local.azurestack.external/fabrikam.partner.onmschina.cn.。

后续步骤

将 ASDK 注册到 Azure