Compartilhar via


Conectar-se ao Azure Stack Hub com o PowerShell como um usuário

Você pode se conectar ao Azure Stack Hub com o PowerShell para gerenciar recursos do Azure Stack Hub. Por exemplo, você pode usar o PowerShell para assinar ofertas, criar VMs (máquinas virtuais) e implantar modelos de Resource Manager do Azure.

As etapas para se preparar são:

  • Verifique se você tem os requisitos.
  • Conecte-se com Microsoft Entra ID ou Serviços de Federação do Active Directory (AD FS) (AD FS).
  • Registre os provedores de recursos.
  • Teste a conectividade.

Pré-requisitos para se conectar ao PowerShell

Configure esses pré-requisitos do kit de desenvolvimento ou de um cliente externo baseado no Windows se você estiver conectado por meio de VPN:

Substitua as seguintes variáveis de script por valores da configuração do Azure Stack Hub:

  • Microsoft Entra nome do locatário
    O nome do locatário Microsoft Entra usado para gerenciar o Azure Stack Hub. Por exemplo, yourdirectory.onmicrosoft.com.
  • Ponto de extremidade de Resource Manager do Azure
    Para o kit do Azure Stack Development, esse valor é definido como https://management.local.azurestack.external. Para obter esse valor para os sistemas integrados do Azure Stack Hub, entre em contato com seu provedor de serviços.

Conectar-se ao Azure Stack Hub com Microsoft Entra ID

    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

Conectar-se ao Azure Stack Hub com o AD FS

# 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"

Registrar provedores de recursos

Os provedores de recursos não são registrados automaticamente para novas assinaturas de usuário que não têm recursos implantados por meio do portal. Você pode registrar explicitamente um provedor de recursos executando o seguinte script:

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

Observação

O AD FS só dá suporte à autenticação interativa com identidades de usuário. Se um objeto de credencial for necessário, você deverá usar uma entidade de serviço (SPN). Para obter mais informações sobre como configurar uma entidade de serviço com o Azure Stack Hub e o AD FS como seu serviço de gerenciamento de identidade, consulte Gerenciar uma identidade de aplicativo do AD FS.

Testar a conectividade

Quando tiver tudo configurado, teste a conectividade usando o PowerShell para criar recursos no Azure Stack Hub. Como teste, crie um grupo de recursos para um aplicativo e adicione uma VM. Execute o seguinte comando para criar um grupo de recursos chamado "MyResourceGroup":

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

Próximas etapas