Conecte-se ao Azure Stack Hub com o PowerShell como utilizadorConnect to Azure Stack Hub with PowerShell as a user

Pode ligar-se ao Azure Stack Hub com o PowerShell para gerir os recursos do Azure Stack Hub.You can connect to Azure Stack Hub with PowerShell to manage Azure Stack Hub resources. Por exemplo, pode utilizar o PowerShell para subscrever ofertas, criar máquinas virtuais (VMs) e implementar modelos de Gestor de Recursos Azure.For example, you can use PowerShell to subscribe to offers, create virtual machines (VMs), and deploy Azure Resource Manager templates.

Para obter a configuração:To get setup:

  • Certifique-se de ter os requisitos.Make sure you have the requirements.
  • Conecte-se com o Azure Ative Directory (Azure AD) ou com os Serviços da Federação de Diretórios Ativos (AD FS).Connect with Azure Active Directory (Azure AD) or Active Directory Federation Services (AD FS).
  • Registar fornecedores de recursos.Register resource providers.
  • Teste a sua conectividade.Test your connectivity.

Pré-requisitos para a ligação com o PowerShellPrerequisites to connecting with PowerShell

Configure estes pré-requisitos a partir do kit de desenvolvimento,ou de um cliente externo baseado no Windows se estiver conectado através da VPN:Configure these prerequisites from the development kit, or from a Windows-based external client if you're connected through VPN:

Certifique-se de que substitui as seguintes variáveis de script por valores da configuração do Azure Stack Hub:Make sure you replace the following script variables with values from your Azure Stack Hub configuration:

  • Nome do inquilino da AD AD AzureAzure AD tenant name
    O nome do seu inquilino AD AZure usado para gerir o Azure Stack Hub.The name of your Azure AD tenant used to manage Azure Stack Hub. Por exemplo, yourdirectory.onmicrosoft.com.For example, yourdirectory.onmicrosoft.com.
  • Ponto final do Gestor de Recursos AzureAzure Resource Manager endpoint
    Para o kit de desenvolvimento da pilha de Azure, este valor está definido para https://management.local.azurestack.external .For Azure Stack Development kit, this value is set to https://management.local.azurestack.external. Para obter este valor para sistemas integrados Azure Stack Hub, contacte o seu fornecedor de serviços.To get this value for Azure Stack Hub integrated systems, contact your service provider.

Ligue ao Azure Stack Hub com Azure ADConnect to Azure Stack Hub with Azure AD

    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

Ligue ao Azure Stack Hub com AD FSConnect to Azure Stack Hub with 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"

Registar fornecedores de recursosRegister resource providers

Os fornecedores de recursos não estão automaticamente registados para novas subscrições de utilizadores que não possuam quaisquer recursos implantados através do portal.Resource providers aren't automatically registered for new user subscriptions that don't have any resources deployed through the portal. Pode registar explicitamente um fornecedor de recursos executando o seguinte script:You can explicitly register a resource provider by running the following script:

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

Nota

O AD FS só suporta a autenticação interativa com identidades do utilizador.AD FS only supports interactive authentication with user identities. Se for necessário um objeto de credencial, deve utilizar um principal de serviço (SPN).If a credential object is required, you must use a service principal (SPN). Para obter mais informações sobre a criação de um principal de serviço com o Azure Stack Hub e a AD FS como o seu serviço de gestão de identidade, consulte Gerir uma identidade de aplicação AD FS.For more information on setting up a service principal with Azure Stack Hub and AD FS as your identity management service, see Manage an AD FS app identity.

Testar a conectividadeTest the connectivity

Quando tiver tudo configurado, teste conectividade usando PowerShell para criar recursos no Azure Stack Hub.When you've got everything setup, test connectivity by using PowerShell to create resources in Azure Stack Hub. Como teste, crie um grupo de recursos para uma aplicação e adicione um VM.As a test, create a resource group for an application and add a VM. Executar o seguinte comando para criar um grupo de recursos chamado "MyResourceGroup":Run the following command to create a resource group named "MyResourceGroup":

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

Passos seguintesNext steps