Bagikan melalui

Get-AzurePublishSettingsFile

  • Referensi
Modul:
Azure

Mengunduh file pengaturan penerbitan untuk langganan Azure.

Catatan

Cmdlet yang dirujuk dalam dokumentasi ini adalah untuk mengelola sumber daya Azure warisan yang menggunakan API Azure Service Manager (ASM). Modul PowerShell warisan ini tidak disarankan saat membuat sumber daya baru karena ASM dijadwalkan untuk dihentikan. Untuk informasi selengkapnya, lihat Penghentian Azure Service Manager.

Modul Az PowerShell adalah modul PowerShell yang direkomendasikan untuk mengelola sumber daya Azure Resource Manager (ARM) dengan PowerShell.

Sintaks

Get-AzurePublishSettingsFile
   [-Environment <String>]
   [-Realm <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Deskripsi

Cmdlet Get-AzurePublishSettingsFile mengunduh file pengaturan penerbitan untuk langganan di akun Anda. Ketika perintah selesai, Anda dapat menggunakan cmdlet Import-PublishSettingsFile untuk membuat pengaturan dalam file tersedia untuk Windows PowerShell.

Untuk membuat akun Azure Anda tersedia untuk Windows PowerShell, Anda bisa menggunakan file pengaturan penerbitan atau cmdlet Add-AzureAccount . Terbitkan file pengaturan memungkinkan Anda menyiapkan sesi terlebih dahulu sehingga Anda dapat menjalankan skrip dan pekerjaan latar belakang tanpa pengawas. Namun, tidak semua layanan mendukung file pengaturan penerbitan. Misalnya, modul AzureResourceManager tidak mendukung file pengaturan penerbitan.

Saat Anda menjalankan Get-AzurePublishSettingsFile, itu membuka browser default Anda dan meminta Anda untuk masuk ke akun Azure Anda, memilih langganan, dan memilih lokasi sistem file untuk file pengaturan penerbitan. Kemudian, ia mengunduh file pengaturan publikasi untuk langganan Anda ke dalam file yang Anda pilih.

"File pengaturan publikasi" adalah file XML dengan ekstensi nama file .publishsettings. File berisi sertifikat yang dikodekan yang menyediakan kredensial manajemen untuk langganan Azure Anda.

Catatan Keamanan: Menerbitkan file pengaturan berisi kredensial yang digunakan untuk mengelola langganan dan layanan Azure Anda. Jika pengguna berbahaya mengakses file pengaturan penerbitan Anda, mereka dapat mengedit, membuat, dan menghapus layanan Azure Anda. Sebagai praktik terbaik keamanan, simpan file ke lokasi di folder Unduhan atau Dokumen Anda lalu hapus setelah menggunakan cmdlet Import-AzurePublishSettingsFile untuk mengimpor pengaturan.

Topik ini menjelaskan cmdlet dalam modul Microsoft Azure PowerShell versi 0.8.10. Untuk mendapatkan versi modul yang Anda gunakan, di konsol Azure PowerShell, ketik (Get-Module -Name Azure).Version.

Contoh

Contoh 1: Mengunduh file pengaturan penerbitan

PS C:\> Get-AzurePublishSettingsFile

Perintah ini membuka browser default Anda, menyambungkan ke akun Windows Azure Anda, lalu mengunduh file .publishsettings untuk akun Anda.

Contoh 2: Tentukan realm

PS C:\> Get-AzurePublishSettingsFile -Realm contoso.com -Passthru

Perintah ini mengunduh file pengaturan publikasi untuk akun di domain contoso.com. Gunakan perintah dengan parameter Realm saat Anda masuk ke Azure dengan akun organisasi, bukan akun Microsoft.

Parameter

-Environment

Menentukan lingkungan Azure.

Lingkungan Azure merupakan penyebaran independen Microsoft Azure, seperti AzureCloud untuk Azure global dan AzureChinaCloud untuk Azure yang dioperasikan oleh 21Vianet di Tiongkok. Anda juga dapat membuat lingkungan Azure lokal dengan menggunakan Azure Pack dan cmdlet WAPack. Untuk informasi selengkapnya, lihat Azure Pack.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-PassThru

Mengembalikan $True jika perintah berhasil dan $False jika gagal. Secara default, cmdlet ini tidak mengembalikan output apa pun.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Profile

Menentukan profil Azure tempat cmdlet ini dibaca. Jika Anda tidak menentukan profil, cmdlet ini akan membaca dari profil default lokal.

Jenis:AzureSMProfile
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Realm

Menentukan organisasi dalam ID organisasi. Misalnya, jika Anda masuk ke Azure sebagai admin@contoso.com, nilai parameter Realm contoso.com. Gunakan parameter ini saat Anda menggunakan ID organisasi untuk masuk ke portal Azure. Parameter ini tidak diperlukan saat Anda menggunakan akun Microsoft, seperti akun outlook.com atau live.com.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

Input

None

Anda dapat menyalurkan input ke cmdlet ini berdasarkan nama properti, tetapi tidak berdasarkan nilai.

Output

None or System.Boolean

Saat Anda menggunakan parameter PassThru , cmdlet ini mengembalikan nilai Boolean. Jika tidak, cmdlet ini tidak mengembalikan output apa pun