Kullanıcı olarak PowerShell ile Azure Stack hub 'ına bağlanmaConnect to Azure Stack Hub with PowerShell as a user

Azure Stack hub kaynaklarını yönetmek için PowerShell ile Azure Stack hub 'ına bağlanabilirsiniz.You can connect to Azure Stack Hub with PowerShell to manage Azure Stack Hub resources. Örneğin, tekliflere abone olmak, sanal makineler (VM 'Ler) oluşturmak ve Azure Resource Manager şablonları dağıtmak için PowerShell 'i kullanabilirsiniz.For example, you can use PowerShell to subscribe to offers, create virtual machines (VMs), and deploy Azure Resource Manager templates.

Kurulumu almak için:To get setup:

  • Gereksinimlerinize sahip olduğunuzdan emin olun.Make sure you have the requirements.
  • Azure Active Directory (Azure AD) veya Active Directory Federasyon Hizmetleri (AD FS) (AD FS) ile bağlantı yapın.Connect with Azure Active Directory (Azure AD) or Active Directory Federation Services (AD FS).
  • Kaynak sağlayıcılarını kaydetme.Register resource providers.
  • Bağlantınızı test edin.Test your connectivity.

PowerShell ile bağlantı kurma önkoşullarıPrerequisites to connecting with PowerShell

Bu önkoşulları geliştirme seti'NDEN veya VPN üzerinden bağlıysanızWindows tabanlı bir dış istemciden yapılandırın:Configure these prerequisites from the development kit, or from a Windows-based external client if you're connected through VPN:

Aşağıdaki betik değişkenlerini Azure Stack hub yapılandırmanızda değerlerle değiştirdiğinizden emin olun:Make sure you replace the following script variables with values from your Azure Stack Hub configuration:

  • Azure AD kiracı adıAzure AD tenant name
    Azure Stack hub 'ını yönetmek için kullanılan Azure AD kiracınızın adı.The name of your Azure AD tenant used to manage Azure Stack Hub. Örneğin, yourdirectory.onmicrosoft.com.For example, yourdirectory.onmicrosoft.com.
  • Azure Resource Manager uç noktasıAzure Resource Manager endpoint
    Azure Stack Development Kit için bu değer olarak ayarlanır https://management.local.azurestack.external .For Azure Stack Development kit, this value is set to https://management.local.azurestack.external. Azure Stack hub tümleşik sistemleri için bu değeri almak üzere hizmet sağlayıcınıza başvurun.To get this value for Azure Stack Hub integrated systems, contact your service provider.

Azure AD ile Azure Stack hub 'a bağlanmaConnect 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

AD FS ile Azure Stack hub 'a bağlanmaConnect 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"

Kaynak sağlayıcılarını kaydetmeRegister resource providers

Kaynak sağlayıcıları, Portal aracılığıyla dağıtılan bir kaynağı olmayan yeni Kullanıcı abonelikleri için otomatik olarak kayıtlı değildir.Resource providers aren't automatically registered for new user subscriptions that don't have any resources deployed through the portal. Aşağıdaki betiği çalıştırarak bir kaynak sağlayıcısını açık bir şekilde kaydedebilirsiniz: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
    }

Not

AD FS yalnızca Kullanıcı kimlikleriyle etkileşimli kimlik doğrulamasını destekler.AD FS only supports interactive authentication with user identities. Bir kimlik bilgisi nesnesi gerekliyse, bir hizmet sorumlusu (SPN) kullanmanız gerekir.If a credential object is required, you must use a service principal (SPN). Azure Stack hub ve AD FS kimlik yönetimi hizmetiniz olarak bir hizmet sorumlusu ayarlama hakkında daha fazla bilgi için bkz. AD FS uygulama kimliğini yönetme.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.

Bağlantıyı test etmeTest the connectivity

Her şeyin kurulumunu yaptıktan sonra, Azure Stack hub 'da kaynak oluşturmak için PowerShell kullanarak bağlantıyı test edin.When you've got everything setup, test connectivity by using PowerShell to create resources in Azure Stack Hub. Test olarak, bir uygulama için bir kaynak grubu oluşturun ve bir VM ekleyin.As a test, create a resource group for an application and add a VM. "MyResourceGroup" adlı bir kaynak grubu oluşturmak için aşağıdaki komutu çalıştırın:Run the following command to create a resource group named "MyResourceGroup":

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

Sonraki adımlarNext steps