Bagikan melalui


Set-AzEnvironment

Mengatur properti untuk lingkungan Azure.

Sintaks

Set-AzEnvironment
   [-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>]
   [[-AzureDataLakeStoreFileSystemEndpointSuffix] <String>]
   [[-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix] <String>]
   [-EnableAdfsAuthentication]
   [[-AdTenant] <String>]
   [[-GraphAudience] <String>]
   [[-DataLakeAudience] <String>]
   [[-BatchEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpoint] <String>]
   [-AzureAnalysisServicesEndpointSuffix <String>]
   [-AzureAnalysisServicesEndpointResourceId <String>]
   [-AzureAttestationServiceEndpointSuffix <String>]
   [-AzureAttestationServiceEndpointResourceId <String>]
   [-AzureSynapseAnalyticsEndpointSuffix <String>]
   [-ContainerRegistryEndpointSuffix <String>]
   [-AzureSynapseAnalyticsEndpointResourceId <String>]
   [-MicrosoftGraphEndpointResourceId <String>]
   [-MicrosoftGraphUrl <String>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzEnvironment
   [-Name] <String>
   [[-StorageEndpoint] <String>]
   [-ARMEndpoint] <String>
   [[-AzureKeyVaultDnsSuffix] <String>]
   [[-AzureKeyVaultServiceEndpointResourceId] <String>]
   [[-DataLakeAudience] <String>]
   [[-BatchEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpoint] <String>]
   [-AzureAnalysisServicesEndpointSuffix <String>]
   [-AzureAnalysisServicesEndpointResourceId <String>]
   [-AzureAttestationServiceEndpointSuffix <String>]
   [-AzureAttestationServiceEndpointResourceId <String>]
   [-AzureSynapseAnalyticsEndpointSuffix <String>]
   [-ContainerRegistryEndpointSuffix <String>]
   [-AzureSynapseAnalyticsEndpointResourceId <String>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet Set-AzEnvironment mengatur titik akhir dan metadata untuk menyambungkan ke instans Azure.

Contoh

Contoh 1: Membuat dan memodifikasi lingkungan baru

Add-AzEnvironment -Name TestEnvironment `
        -ActiveDirectoryEndpoint TestADEndpoint `
        -ActiveDirectoryServiceEndpointResourceId TestADApplicationId `
        -ResourceManagerEndpoint TestRMEndpoint `
        -GalleryEndpoint TestGalleryEndpoint `
        -GraphEndpoint TestGraphEndpoint

Name            Resource Manager Url ActiveDirectory Authority
----            -------------------- -------------------------
TestEnvironment TestRMEndpoint       TestADEndpoint/

Set-AzEnvironment -Name TestEnvironment `
        -ActiveDirectoryEndpoint NewTestADEndpoint `
        -GraphEndpoint NewTestGraphEndpoint | Format-List

Name                                              : TestEnvironment
EnableAdfsAuthentication                          : False
ActiveDirectoryServiceEndpointResourceId          : TestADApplicationId
AdTenant                                          :
GalleryUrl                                        : TestGalleryEndpoint
ManagementPortalUrl                               :
ServiceManagementUrl                              : 
PublishSettingsFileUrl                            :
ResourceManagerUrl                                : TestRMEndpoint
SqlDatabaseDnsSuffix                              :
StorageEndpointSuffix                             :
ActiveDirectoryAuthority                          : NewTestADEndpoint
GraphUrl                                          : NewTestGraphEndpoint
GraphEndpointResourceId                           :
TrafficManagerDnsSuffix                           :
AzureKeyVaultDnsSuffix                            :
AzureDataLakeStoreFileSystemEndpointSuffix        :
AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix :
AzureKeyVaultServiceEndpointResourceId            :
BatchEndpointResourceId                           :
AzureOperationalInsightsEndpoint                  :
AzureOperationalInsightsEndpointResourceId        :
AzureAttestationServiceEndpointSuffix             :
AzureAttestationServiceEndpointResourceId         :
AzureSynapseAnalyticsEndpointSuffix               :
AzureSynapseAnalyticsEndpointResourceId           :

Dalam contoh ini kita membuat lingkungan Azure baru dengan titik akhir sampel menggunakan Add-AzEnvironment, lalu kita mengubah nilai atribut ActiveDirectoryEndpoint dan GraphEndpoint dari lingkungan yang dibuat menggunakan cmdlet Set-AzEnvironment.

Parameter

-ActiveDirectoryEndpoint

Menentukan otoritas dasar untuk autentikasi Azure Active Directory.

Jenis:String
Alias:AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority
Position:5
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ActiveDirectoryServiceEndpointResourceId

Menentukan audiens untuk token yang mengautentikasi permintaan ke titik akhir Azure Resource Manager atau Manajemen Layanan (RDFE).

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

-AdTenant

Menentukan penyewa Direktori Aktif default.

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

-ARMEndpoint

Titik akhir Azure Resource Manager.

Jenis:String
Alias:ArmUrl
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-AzureAnalysisServicesEndpointResourceId

Pengidentifikasi sumber daya sumber daya Azure Analysis Services.

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

-AzureAnalysisServicesEndpointSuffix

Titik akhir yang akan digunakan saat berkomunikasi dengan AZURE Log Analytics API.

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

-AzureAttestationServiceEndpointResourceId

Pengidentifikasi sumber daya layanan Azure Attestation yang merupakan penerima token yang diminta.

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

-AzureAttestationServiceEndpointSuffix

Akhiran dns layanan Azure Attestation.

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

-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix

Akhiran Dns layanan pekerjaan dan katalog Azure Data Lake Analytics

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

-AzureDataLakeStoreFileSystemEndpointSuffix

Akhiran Dns Azure Data Lake Store FileSystem. Contoh: azuredatalake.net

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

-AzureKeyVaultDnsSuffix

Akhiran dns layanan Azure Key Vault. Contohnya adalah vault-int.azure-int.net

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

-AzureKeyVaultServiceEndpointResourceId

Pengidentifikasi sumber daya layanan data Azure Key Vault yang merupakan penerima token yang diminta.

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

-AzureOperationalInsightsEndpoint

Titik akhir yang akan digunakan saat berkomunikasi dengan AZURE Log Analytics API.

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

-AzureOperationalInsightsEndpointResourceId

Audiens untuk token yang mengautentikasi dengan AZURE Log Analytics API.

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

-AzureSynapseAnalyticsEndpointResourceId

Pengidentifikasi sumber daya Azure Synapse Analytics yang merupakan penerima token yang diminta.

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

-AzureSynapseAnalyticsEndpointSuffix

Akhiran dns Azure Synapse Analytics.

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

-BatchEndpointResourceId

Pengidentifikasi sumber daya layanan Azure Batch yang merupakan penerima token yang diminta

Jenis:String
Alias:BatchResourceId, BatchAudience
Position:20
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ContainerRegistryEndpointSuffix

Akhiran Azure Container Registry.

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

-DataLakeAudience

Audiens untuk token yang mengautentikasi dengan Titik Akhir layanan AD Data Lake.

Jenis:String
Alias:DataLakeEndpointResourceId, DataLakeResourceId
Position:19
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-EnableAdfsAuthentication

Menunjukkan bahwa autentikasi lokal Active Directory Federation Services (ADFS) diizinkan.

Jenis:SwitchParameter
Alias:OnPremise
Position:16
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-GalleryEndpoint

Menentukan titik akhir untuk galeri templat penyebaran Azure Resource Manager. Parameternya adalah mengatur nilai ke GalleryUrl dari PSAzureEnvironment. Seperti GalleryUrl yang dihapus dari ArmMetadata, Azure PowerShell tidak akan lagi menyediakan nilai sehingga tidak disarankan untuk diatur GalleryEndpoint lagi.

Jenis:String
Alias:Gallery, GalleryUrl
Position:7
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-GraphAudience

Audiens untuk token yang mengautentikasi dengan Ad Graph Endpoint.

Jenis:String
Alias:GraphEndpointResourceId, GraphResourceId
Position:18
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-GraphEndpoint

Menentukan URL untuk permintaan Graph (metadata Direktori Aktif).

Jenis:String
Alias:Graph, GraphUrl
Position:9
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ManagementPortalUrl

Menentukan URL untuk Portal Manajemen.

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

-MicrosoftGraphEndpointResourceId

Pengidentifikasi sumber daya Microsoft Graph

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

-MicrosoftGraphUrl

Microsoft Graph Url

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

-Name

Menentukan nama lingkungan yang akan diubah.

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

-PublishSettingsFileUrl

Menentukan URL tempat file .publishsettings dapat diunduh.

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

-ResourceManagerEndpoint

Menentukan URL untuk permintaan Azure Resource Manager.

Jenis:String
Alias:ResourceManager, ResourceManagerUrl
Position:6
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Scope

Menentukan cakupan perubahan konteks, misalnya, apakah perubahan hanya berlaku untuk proses saat ini, atau untuk semua sesi yang dimulai oleh pengguna ini.

Jenis:ContextModificationScope
Nilai yang diterima:Process, CurrentUser
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ServiceEndpoint

Menentukan titik akhir untuk permintaan Manajemen Layanan (RDFE).

Jenis:String
Alias:ServiceManagement, ServiceManagementUrl
Position:2
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-SqlDatabaseDnsSuffix

Menentukan akhiran nama domain untuk server Azure SQL Database.

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

-StorageEndpoint

Menentukan titik akhir untuk akses penyimpanan (blob, tabel, antrean, dan file).

Jenis:String
Alias:StorageEndpointSuffix
Position:4
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-TrafficManagerDnsSuffix

Menentukan akhiran nama domain untuk layanan Azure Traffic Manager.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

SwitchParameter

Output

PSAzureEnvironment