Bagikan melalui

Set-AzureSubscription

  • Referensi
Modul:
Azure

Mengubah 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

Set-AzureSubscription
   -SubscriptionId <String>
   [-Certificate <X509Certificate2>]
   [-ServiceEndpoint <String>]
   [-ResourceManagerEndpoint <String>]
   [-CurrentStorageAccountName <String>]
   [-Context <AzureStorageContext>]
   [-Environment <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureSubscription
   -SubscriptionName <String>
   [-Certificate <X509Certificate2>]
   [-ServiceEndpoint <String>]
   [-ResourceManagerEndpoint <String>]
   [-CurrentStorageAccountName <String>]
   [-Context <AzureStorageContext>]
   [-Environment <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Set-AzureSubscription
   -SubscriptionName <String>
   -SubscriptionId <String>
   -Certificate <X509Certificate2>
   [-ServiceEndpoint <String>]
   [-ResourceManagerEndpoint <String>]
   [-CurrentStorageAccountName <String>]
   [-Context <AzureStorageContext>]
   [-Environment <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Deskripsi

Cmdlet Set-AzureSubscription menetapkan dan mengubah properti objek langganan Azure. Anda dapat menggunakan cmdlet ini untuk bekerja dalam langganan Azure yang bukan langganan default Anda atau untuk mengubah akun penyimpanan Anda saat ini. Untuk informasi tentang langganan saat ini dan default, lihat cmdlet Select-AzureSubscription .

Cmdlet ini beroperasi pada objek langganan Azure, bukan langganan Azure Anda yang sebenarnya. Untuk membuat dan memprovisikan langganan Azure, kunjungi Portal Microsoft Azure (https://azure.microsoft.com/).

Cmdlet ini mengubah data dalam file data langganan yang Anda buat saat menggunakan cmdlet Add-AzureAccount atau Import-AzurePublishSettingsFile untuk menambahkan akun Azure ke Windows PowerShell.

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: Mengubah langganan yang sudah ada1

C:\PS> $thumbprint = <Thumbprint-2>
C:\PS> $differentCert = Get-Item cert:\\CurrentUser\My\$thumbprint
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $differentCert

Contoh ini mengubah sertifikat untuk langganan bernama ContosoEngineering.

Contoh 2: Mengubah titik akhir layanan

C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -ServiceEndpoint "https://management.core.contoso.com"

Perintah ini menambahkan atau mengubah titik akhir layanan kustom untuk langganan ContosoEngineering.

Contoh 3: Menghapus nilai properti

C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $null -ResourceManagerEndpoint $Null

Perintah ini mengatur nilai properti Sertifikat dan ResourceManagerEndpoint ke null ($Null). Ini menghapus nilai properti tersebut tanpa mengubah pengaturan lain.

Contoh 4: Menggunakan file data langganan alternatif

C:\PS> Set-AzureSubscription -SubscriptionName ContosoFinance -SubscriptionDataFile C:\Azure\SubscriptionData.xml -CurrentStorageAccount ContosoStorage01

Perintah ini mengubah akun penyimpanan langganan ContosoFinance saat ini menjadi ContosoStorage01. Perintah menggunakan parameter SubscriptionDataFile untuk mengubah data dalam file data langganan C:\Azure\SubscriptionData.xml. Secara default, Set-AzureSubscription menggunakan file data langganan default di profil pengguna roaming Anda.

Parameter

-Certificate

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

-Context

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

-CurrentStorageAccountName

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

-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:False
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:False
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

-ResourceManagerEndpoint

Menentukan titik akhir untuk data Azure Resource Manager, termasuk data tentang grup sumber daya yang terkait dengan akun tersebut. Untuk informasi selengkapnya tentang Azure Resource Manager, lihat Cmdlet Azure Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394765) dan Menggunakan Windows PowerShell dengan Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).

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

-ServiceEndpoint

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

-SubscriptionId

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

-SubscriptionName

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
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. Secara default, cmdlet ini tidak mengembalikan output apa pun.