Ligar ao Azure Stack Hub com o PowerShell

  • Artigo

Pode configurar o Azure Stack Hub para utilizar o PowerShell para gerir recursos como criar ofertas, planos, quotas e alertas. Este tópico ajuda-o a configurar o ambiente do operador.

Pré-requisitos

Execute os seguintes pré-requisitos a partir do Azure Stack Development Kit (ASDK) ou de um cliente externo baseado no Windows se estiver ligado ao ASDK através de VPN.

Ligar com Microsoft Entra ID

Para configurar o ambiente de operador do Azure Stack Hub com o PowerShell, execute um dos scripts abaixo. Substitua os valores de ponto final Microsoft Entra tenantName e Azure Resource Manager pela sua própria configuração de ambiente.

Nota

Se a sua sessão expirar, a palavra-passe tiver sido alterada ou quiser simplesmente mudar de conta, execute o seguinte cmdlet antes de iniciar sessão com o Connect-AzAccount: Remove-AzAccount -Scope Process

    # Register an Azure Resource Manager environment that targets your Azure Stack Hub instance. Get your Azure Resource Manager endpoint value from your service provider.
    Add-AzEnvironment -Name "AzureStackAdmin" -ArmEndpoint "https://adminmanagement.local.azurestack.external" `
      -AzureKeyVaultDnsSuffix adminvault.local.azurestack.external `
      -AzureKeyVaultServiceEndpointResourceId https://adminvault.local.azurestack.external

    # Set your tenant name.
    $AuthEndpoint = (Get-AzEnvironment -Name "AzureStackAdmin").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 "AzureStackAdmin" -TenantId $TenantId

Ligar ao AD FS

Ligue-se ao ambiente de operador do Azure Stack Hub com o PowerShell com Microsoft Entra Serviços Federados de ID (Azure AD FS). Para o ASDK, este ponto final Resource Manager do Azure está definido como https://adminmanagement.local.azurestack.external. Para obter o ponto final do Azure Resource Manager para sistemas integrados do Azure Stack Hub, contacte o fornecedor de serviços.

# Register an Azure Resource Manager environment that targets your Azure Stack Hub instance. Get your Azure Resource Manager endpoint value from your service provider.
  Add-AzEnvironment -Name "AzureStackAdmin" -ArmEndpoint "https://adminmanagement.local.azurestack.external" `
    -AzureKeyVaultDnsSuffix adminvault.local.azurestack.external `
    -AzureKeyVaultServiceEndpointResourceId https://adminvault.local.azurestack.external

# Sign in to your environment.
Connect-AzAccount -EnvironmentName "AzureStackAdmin"

Nota

O AD FS só suporta autenticação interativa com identidades de utilizador. Se for necessário um objeto de credencial, tem de utilizar um principal de serviço (SPN). Para obter mais informações sobre como configurar um principal de serviço com o Azure Stack Hub e o AD FS como o seu serviço de gestão de identidades, veja Gerir uma identidade de aplicação do AD FS.

Testar a conectividade

Agora que já tem tudo configurado, utilize o PowerShell para criar recursos no Azure Stack Hub. Por exemplo, pode criar um grupo de recursos para uma aplicação e adicionar uma máquina virtual. Utilize o seguinte comando para criar um grupo de recursos com o nome MyResourceGroup.

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

Passos seguintes