Add-AzureEnvironment
Membuat 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
Add-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 Add-AzureEnvironment membuat lingkungan akun Azure kustom baru dan menyimpannya di profil pengguna roaming Anda. Cmdlet mengembalikan objek yang mewakili lingkungan baru. Ketika perintah selesai, Anda dapat menggunakan lingkungan di Windows PowerShell.
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.
Hanya parameter Nama cmdlet ini yang wajib. Jika Anda menghilangkan parameter, nilainya adalah null ($Null), dan layanan yang menggunakan titik akhir tersebut mungkin tidak berfungsi dengan baik. Untuk menambahkan atau mengubah nilai properti lingkungan, gunakan cmdlet Set-AzureEnvironment .
CATATAN: Mengubah lingkungan Anda dapat menyebabkan akun Anda gagal. Biasanya, lingkungan ditambahkan hanya untuk pengujian atau pemecahan masalah.
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: Menambahkan lingkungan Azure
PS C:\> Add-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl https://contoso.com/fwlink/?LinkID=101 -ServiceEndpoint https://contoso.com/fwlink/?LinkID=102
Name : ContosoEnv
PublishSettingsFileUrl : https://contoso.com/fwlink/?LinkID=101
ServiceEndpoint : https://contoso.com/fwlink/?LinkID=102
ResourceManagerEndpoint :
ManagementPortalUrl :
ActiveDirectoryEndpoint :
ActiveDirectoryCommonTenantId :
StorageEndpointSuffix :
StorageBlobEndpointFormat :
StorageQueueEndpointFormat :
StorageTableEndpointFormat :
GalleryEndpoint :Perintah ini membuat lingkungan ContosoEnv Azure.
Parameter
-ActiveDirectoryEndpoint
Menentukan titik akhir untuk autentikasi Microsoft Entra di lingkungan baru.
| 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
Menentukan titik akhir untuk galeri Azure Resource Manager, yang menyimpan templat galeri grup sumber daya. Untuk informasi selengkapnya tentang grup sumber daya Azure dan templat galeri, lihat topik bantuan untuk Get-AzureResourceGroupGalleryTemplatehttps://go.microsoft.com/fwlink/?LinkID=393052.
| 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
Menentukan URL Portal Manajemen Azure di lingkungan baru.
| Jenis: | String |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | True |
| Terima karakter wildcard: | False |
-Name
Menentukan nama untuk lingkungan. Parameter ini diperlukan. Jangan gunakan nama lingkungan default, AzureCloud, dan AzureChinaCloud.
| 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
Menentukan URL file pengaturan penerbitan untuk akun Anda. 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
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 |
| Alias: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | True |
| Terima karakter wildcard: | False |
-ServiceEndpoint
Menentukan URL titik akhir layanan Azure. 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
Menentukan titik akhir default layanan penyimpanan di lingkungan baru.
| 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