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

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

测试 Azure Stack - 安装成功

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

启用多租户

对于使用 Azure AD 的部署,需要为 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