Get-AzurePublishSettingsFile
Azure aboneliği için yayımlama ayarları dosyasını indirir.
Not
Bu belgelerde başvuruda bulunan cmdlet'ler, Azure Service Manager (ASM) API'lerini kullanan eski Azure kaynaklarını yönetmeye yöneliktir. ASM kullanımdan kaldırılmış olarak zamanlandığından, yeni kaynaklar oluşturulurken bu eski PowerShell modülü önerilmez. Daha fazla bilgi için bkz . Azure Service Manager'ın kullanımdan kaldırılması.
Az PowerShell modülü, Azure Resource Manager (ARM) kaynaklarını PowerShell ile yönetmek için önerilen PowerShell modülüdür.
Sözdizimi
Get-AzurePublishSettingsFile
[-Environment <String>]
[-Realm <String>]
[-PassThru]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
Get-AzurePublishSettingsFile cmdlet'i hesabınızdaki bir abonelik için yayımlama ayarları dosyasını indirir. Komut tamamlandığında, dosyadaki ayarları Windows PowerShell'in kullanımına açmak için Import-PublishSettingsFile cmdlet'ini kullanabilirsiniz.
Azure hesabınızı Windows PowerShell'in kullanımına açmak için bir yayımlama ayarları dosyası veya Add-AzureAccount cmdlet'ini kullanabilirsiniz. Yayımlama ayarları dosyaları, betikleri ve arka plan işlerini katılımsız çalıştırabilmeniz için oturumu önceden hazırlamanıza olanak tanır. Ancak, tüm hizmetler yayımlama ayarları dosyalarını desteklemez. Örneğin, AzureResourceManager modülü yayımlama ayarları dosyalarını desteklemez.
Get-AzurePublishSettingsFile komutunu çalıştırdığınızda, varsayılan tarayıcınızı açar ve Azure hesabınızda oturum açmanızı, bir abonelik seçmenizi ve yayımlama ayarları dosyası için bir dosya sistemi konumu seçmenizi ister. Ardından aboneliğinizin yayımlama ayarları dosyasını seçtiğiniz dosyaya indirir.
"Yayımlama ayarları dosyası", .publishsettings dosya adı uzantısına sahip bir XML dosyasıdır. Dosya, Azure abonelikleriniz için yönetim kimlik bilgileri sağlayan kodlanmış bir sertifika içerir.
Güvenlik Notu: Yayımlama ayarları dosyaları, Azure aboneliklerinizi ve hizmetlerinizi yönetmek için kullanılan kimlik bilgilerini içerir. Kötü amaçlı kullanıcılar yayımlama ayarları dosyanıza erişirse Azure hizmetlerinizi düzenleyebilir, oluşturabilir ve silebilir. En iyi güvenlik uygulaması olarak, dosyayı İndirmeler veya Belgeler klasörünüzdeki bir konuma kaydedin ve import-AzurePublishSettingsFile cmdlet'ini kullanarak ayarları içeri aktardıktan sonra silin.
Bu konuda, Microsoft Azure PowerShell modülünün 0.8.10 sürümündeki cmdlet açıklanmaktadır.
Kullandığınız modülün sürümünü almak için Azure PowerShell konsoluna yazın (Get-Module -Name Azure).Version
.
Örnekler
Örnek 1: Yayımlama ayarları dosyasını indirme
PS C:\> Get-AzurePublishSettingsFile
Bu komut varsayılan tarayıcınızı açar, Windows Azure hesabınıza bağlanır ve ardından hesabınız için .publishsettings dosyasını indirir.
Örnek 2: Bölge belirtme
PS C:\> Get-AzurePublishSettingsFile -Realm contoso.com -Passthru
Bu komut, contoso.com etki alanındaki bir hesabın yayımlama ayarları dosyasını indirir. Azure'da Microsoft hesabı yerine bir kuruluş hesabıyla oturum açarken Realm parametresiyle bir komut kullanın.
Parametreler
-Environment
Bir Azure ortamını belirtir.
Azure ortamı, Microsoft Azure'ın bağımsız dağıtımıdır. Örneğin küresel Azure için AzureCloud ve Çin'de 21Vianet tarafından sağlanan Azure için AzureChinaCloud. Ayrıca Azure Pack ve WAPack cmdlet'lerini kullanarak şirket içi Azure ortamları oluşturabilirsiniz. Daha fazla bilgi için bkz . Azure Paketi.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-PassThru
Komut başarılı olursa $True ve başarısız olursa $False döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış döndürmez.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Profile
Bu cmdlet'in okuduğu Azure profilini belirtir. Bir profil belirtmezseniz, bu cmdlet yerel varsayılan profilden okur.
Tür: | AzureSMProfile |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Realm
Kuruluş kimliğindeki kuruluşu belirtir. Örneğin, Azure'da olarak admin@contoso.comoturum açarsanız, Realm parametresinin değeri contoso.com. Azure portalında oturum açmak için bir kuruluş kimliği kullandığınızda bu parametreyi kullanın. Outlook.com veya live.com hesabı gibi bir Microsoft hesabı kullandığınızda bu parametre gerekli değildir.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
Girişler
None
Bu cmdlet'e giriş kanalını özellik adına göre yapabilirsiniz, ancak değere göre kanala geçiremezsiniz.
Çıkışlar
None or System.Boolean
PassThru parametresini kullandığınızda, bu cmdlet bir Boole değeri döndürür. Aksi takdirde, bu cmdlet herhangi bir çıkış döndürmez