Set-AzureEnvironment
Mengubah properti lingkungan 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-AzureEnvironment
-Name <String>
[-PublishSettingsFileUrl <String>]
[-ServiceEndpoint <String>]
[-ManagementPortalUrl <String>]
[-StorageEndpoint <String>]
[-ActiveDirectoryEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-GalleryEndpoint <String>]
[-ActiveDirectoryServiceEndpointResourceId <String>]
[-GraphEndpoint <String>]
[-AzureKeyVaultDnsSuffix <String>]
[-AzureKeyVaultServiceEndpointResourceId <String>]
[-TrafficManagerDnsSuffix <String>]
[-SqlDatabaseDnsSuffix <String>]
[-EnableAdfsAuthentication]
[-AdTenant <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Deskripsi
Cmdlet Set-AzureEnvironment mengubah properti lingkungan Azure. Ini mengembalikan objek yang mewakili lingkungan dengan nilai properti barunya. Gunakan parameter Nama untuk mengidentifikasi lingkungan dan parameter lainnya untuk mengubah nilai properti. Anda tidak dapat menggunakan Set-AzureEnvironment untuk mengubah nama 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.
CATATAN: Jangan ubah properti lingkungan AzureCloud atau AzureChinaCloud. Gunakan cmdlet ini untuk mengubah nilai lingkungan privat yang Anda buat.
Contoh
Contoh 1: Mengubah properti lingkungan
PS C:\> Set-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl "https://contoso.com" -StorageEndpoint "contoso.com"
Perintah ini mengubah nilai properti PublishSettingsFileUrl dan StorageEndpoint lingkungan ContosoEnv.
Parameter
-ActiveDirectoryEndpoint
Mengubah titik akhir untuk autentikasi Microsoft Entra ke nilai yang ditentukan.
Jenis: | String |
Alias: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-ActiveDirectoryServiceEndpointResourceId
Menentukan ID sumber daya API manajemen yang aksesnya dikelola oleh ID Microsoft Entra.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-AdTenant
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-AzureKeyVaultDnsSuffix
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-AzureKeyVaultServiceEndpointResourceId
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-EnableAdfsAuthentication
Jenis: | SwitchParameter |
Alias: | OnPremise |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-GalleryEndpoint
Mengubah titik akhir untuk galeri Azure Resource Manager ke nilai yang ditentukan. Titik akhir galeri adalah lokasi untuk templat galeri grup sumber daya. Untuk informasi selengkapnya tentang grup sumber daya Azure dan templat galeri, lihat topik bantuan untuk Get-AzureResourceGroupGalleryTemplate.
Jenis: | String |
Alias: | Gallery, GalleryUrl |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-GraphEndpoint
Jenis: | String |
Alias: | Graph, GraphUrl |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-ManagementPortalUrl
Mengubah URL Portal Manajemen Azure ke nilai yang ditentukan.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Name
Mengidentifikasi lingkungan yang sedang diubah. Parameter ini diperlukan. Nilai parameter peka huruf besar/kecil. Karakter kartubebas tidak diizinkan.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
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 |
-PublishSettingsFileUrl
Mengubah URL untuk menerbitkan file pengaturan di lingkungan yang ditentukan. File pengaturan penerbitan Azure adalah file XML yang berisi informasi tentang akun Anda dan sertifikat manajemen yang memungkinkan Windows PowerShell untuk masuk ke akun Azure Anda atas nama Anda.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-ResourceManagerEndpoint
Mengubah 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 |
Alias: | ResourceManager, ResourceManagerUrl |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-ServiceEndpoint
Mengubah URL titik akhir layanan Azure di lingkungan yang ditentukan. Titik akhir layanan Azure menentukan apakah aplikasi Anda dikelola oleh platform Azure global, Azure yang dioperasikan oleh 21Vianet di Tiongkok, atau penginstalan Azure privat.
Jenis: | String |
Alias: | ServiceManagement, ServiceManagementUrl |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-SqlDatabaseDnsSuffix
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-StorageEndpoint
Mengubah titik akhir default layanan penyimpanan di lingkungan yang ditentukan.
Jenis: | String |
Alias: | StorageEndpointSuffix |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-TrafficManagerDnsSuffix
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
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment