以使用者的身分使用 PowerShell 連線到 Azure Stack Hub

您可以使用 PowerShell 連線到 Azure Stack Hub,以管理 Azure Stack Hub 資源。 例如,您可以使用 PowerShell 來訂閱供應項目、建立虛擬機器 (VM) 及部署 Azure Resource Manager 範本。

若要進行設定:

  • 確定您具有必要項目。
  • 與 Azure Active Directory (Azure AD) 或「Active Directory 同盟服務」(AD FS) 連線。
  • 註冊資源提供者。
  • 測試連線能力。

使用 PowerShell 連線的必要條件

開發套件,或從 Windows 型外部用戶端 (如果您透過 VPN 連線),設定下列必要條件:

務必使用 Azure Stack Hub 組態中的值取代下列指令碼變數:

  • Azure AD 租用戶名稱
    用來管理 Azure Stack Hub 的 Azure AD 租用戶名稱。 例如 yourdirectory.onmicrosoft.com。
  • Azure Resource Manager 端點
    針對 Azure Stack 開發套件,此值會設定為 https://management.local.azurestack.external。 若要取得 Azure Stack Hub 整合式系統的這個值,請與您的服務提供者連絡。

使用 Azure AD 來連線到 Azure Stack Hub

    Add-AzEnvironment -Name "AzureStackUser" -ArmEndpoint "https://management.local.azurestack.external"
    # Set your tenant name
    $AuthEndpoint = (Get-AzEnvironment -Name "AzureStackUser").ActiveDirectoryAuthority.TrimEnd('/')
    $AADTenantName = "<myDirectoryTenantName>.onmicrosoft.com"
    $TenantId = (invoke-restmethod "$($AuthEndpoint)/$($AADTenantName)/.well-known/openid-configuration").issuer.TrimEnd('/').Split('/')[-1]

    # After signing in to your environment, Azure Stack Hub cmdlets
    # can be easily targeted at your Azure Stack Hub instance.
    Connect-AzAccount -EnvironmentName "AzureStackUser" -TenantId $TenantId

使用 AD FS 來連線到 Azure Stack Hub

# Register an Azure Resource Manager environment that targets your Azure Stack Hub instance
Add-AzEnvironment -Name "AzureStackUser" -ArmEndpoint "https://management.local.azurestack.external"

# Sign in to your environment
Connect-AzAccount -EnvironmentName "AzureStackUser"

註冊資源提供者

沒有透過入口網站部署任何資源的新使用者訂用帳戶,並不會自動註冊資源提供者。 執行下列指令碼,即可明確註冊資源提供者:

foreach($s in (Get-AzSubscription)) {
        Select-AzSubscription -SubscriptionId $s.SubscriptionId | Out-Null
        Write-Progress $($s.SubscriptionId + " : " + $s.SubscriptionName)
Get-AzResourceProvider -ListAvailable | Register-AzResourceProvider
    }

注意

AD FS 僅支援利用使用者身分識別的互動式驗證。 如果需要認證物件,您必須使用服務主體 (SPN)。 如需使用 Azure Stack Hub 和 AD FS 將服務主體設定為身分識別管理服務的詳細資訊,請參閱管理 AD FS 應用程式身分識別

測試連線

當您將一切設定妥當時,請使用 PowerShell 在 Azure Stack Hub 中建立資源,以測試連線能力。 在測試時,請建立應用程式的資源群組,並新增 VM。 若要建立名為 "MyResourceGroup" 的資源群組,請執行下列命令:

New-AzResourceGroup -Name "MyResourceGroup" -Location "Local"

後續步驟