Conectar-se ao Hub de Azure Stack com o PowerShellConnect to Azure Stack Hub with PowerShell

Você pode configurar o Hub de Azure Stack para usar o PowerShell para gerenciar recursos como criar ofertas, planos, cotas e alertas.You can configure Azure Stack Hub to use PowerShell to manage resources like creating offers, plans, quotas, and alerts. Este tópico ajuda você a configurar o ambiente do operador.This topic helps you configure the operator environment.

Pré-requisitosPrerequisites

Execute os seguintes pré-requisitos do Kit de desenvolvimento do Azure Stack (ASDK) ou de um cliente externo baseado no Windows se você estiver conectado ao ASDK por meio de VPN.Run the following prerequisites either from the Azure Stack Development Kit (ASDK) or from a Windows-based external client if you're connected to the ASDK through VPN.

Conectar-se ao Azure ADConnect with Azure AD

Para configurar o ambiente do operador Hub Azure Stack com o PowerShell, execute um dos scripts abaixo.To configure the Azure Stack Hub operator environment with PowerShell, run one of the scripts below. Substitua os valores de locatárioname do Azure Active Directory (Azure AD) e Azure Resource Manager ponto de extremidade pela sua própria configuração de ambiente.Replace the Azure Active Directory (Azure AD) tenantName and Azure Resource Manager endpoint values with your own environment configuration.

Observação

If your session expires, your password has changed, or you simply wish to switch accounts, run the following cmdlet before you sign in using Add-AzureRmAccount: Remove-AzureRmAccount -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-AzureRmEnvironment -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.
    Add-AzureRmAccount -EnvironmentName "AzureStackAdmin" -TenantId $TenantId

Conectar-se com AD FSConnect with AD FS

Conecte-se ao ambiente do operador de Hub de Azure Stack com o PowerShell com Azure Active Directory serviços federados (Azure AD FS).Connect to the Azure Stack Hub operator environment with PowerShell with Azure Active Directory Federated Services (Azure AD FS). Para o ASDK, esse ponto de extremidade Azure Resource Manager é definido como https://adminmanagement.local.azurestack.external .For the ASDK, this Azure Resource Manager endpoint is set to https://adminmanagement.local.azurestack.external. Para obter o ponto de extremidade Azure Resource Manager para sistemas integrados de Azure Stack Hub, entre em contato com seu provedor de serviços.To get the Azure Resource Manager endpoint for Azure Stack Hub integrated systems, contact your service provider.

# 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.
Login-AzureRmAccount -EnvironmentName "AzureStackAdmin"

Observação

AD FS só dá suporte à autenticação interativa com identidades de usuário.AD FS only supports interactive authentication with user identities. Se um objeto de credencial for necessário, você deverá usar uma entidade de serviço (SPN).If a credential object is required, you must use a service principal (SPN). Para obter mais informações sobre como configurar uma entidade de serviço com Azure Stack Hub e AD FS como seu serviço de gerenciamento de identidade, consulte gerenciar uma identidade de aplicativo 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

Agora que você tem tudo configurado, use o PowerShell para criar recursos dentro de Azure Stack Hub.Now that you've got everything set-up, use PowerShell to create resources within Azure Stack Hub. Por exemplo, você pode criar um grupo de recursos para um aplicativo e adicionar uma máquina virtual.For example, you can create a resource group for an app and add a virtual machine. Use o comando a seguir para criar um grupo de recursos chamado MyResource Group.Use the following command to create a resource group named MyResourceGroup.

New-AzureRmResourceGroup -Name "MyResourceGroup" -Location "Local"

Próximas etapasNext steps