Set-AzureRmEnvironment
Nastaví vlastnosti pro prostředí Azure.
Upozorňující
Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntaxe
Set-AzureRmEnvironment
[-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>]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureRmEnvironment
[-Name] <String>
[[-StorageEndpoint] <String>]
[-ARMEndpoint] <String>
[[-AzureKeyVaultDnsSuffix] <String>]
[[-AzureKeyVaultServiceEndpointResourceId] <String>]
[[-DataLakeAudience] <String>]
[[-BatchEndpointResourceId] <String>]
[[-AzureOperationalInsightsEndpointResourceId] <String>]
[[-AzureOperationalInsightsEndpoint] <String>]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Rutina Set-AzureRMEnvironment nastavuje koncové body a metadata pro připojení k instanci Azure.
Příklady
Příklad 1: Vytvoření a úprava nového prostředí
PS C:\> Add-AzureRmEnvironment -Name TestEnvironment `
-ActiveDirectoryEndpoint TestADEndpoint `
-ActiveDirectoryServiceEndpointResourceId TestADApplicationId `
-ResourceManagerEndpoint TestRMEndpoint `
-GalleryEndpoint TestGalleryEndpoint `
-GraphEndpoint TestGraphEndpoint
Name Resource Manager Url ActiveDirectory Authority
---- -------------------- -------------------------
TestEnvironment TestRMEndpoint TestADEndpoint/
PS C:\> Set-AzureRmEnvironment -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 :V tomto příkladu vytváříme nové prostředí Azure s ukázkovými koncovými body pomocí Add-AzureRmEnvironment a pak měníme hodnotu atributů ActiveDirectoryEndpoint a GraphEndpoint vytvořeného prostředí pomocí rutiny Set-AzureRmEnvironment.
Parametry
-ActiveDirectoryEndpoint
Určuje základní autoritu pro ověřování Microsoft Entra.
| Typ: | String |
| Aliasy: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | 5 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ActiveDirectoryServiceEndpointResourceId
Určuje cílovou skupinu pro tokeny, které ověřují požadavky na koncové body Azure Resource Manageru nebo správy služeb (RDFE).
| Typ: | String |
| Position: | 8 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-AdTenant
Určuje výchozího tenanta služby Active Directory.
| Typ: | String |
| Position: | 17 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ARMEndpoint
Koncový bod Azure Resource Manageru
| Typ: | String |
| Aliasy: | ArmUrl |
| Position: | 1 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-AzureAnalysisServicesEndpointSuffix
Přípona DNS koncových bodů služby Azure Analysis Services
| Typ: | String |
| Position: | 15 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix
Přípona DNS pro úlohy a katalogové služby Azure Data Lake Analytics
| Typ: | String |
| Position: | 15 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-AzureDataLakeStoreFileSystemEndpointSuffix
Přípona DNS systému souborů Azure Data Lake Store Příklad: azuredatalake.net
| Typ: | String |
| Position: | 14 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-AzureKeyVaultDnsSuffix
Určuje příponu názvu domény pro služby Key Vault.
| Typ: | String |
| Position: | 10 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-AzureKeyVaultServiceEndpointResourceId
Určuje cílovou skupinu pro přístupové tokeny, které autorizuje požadavky na služby Key Vault.
| Typ: | String |
| Position: | 11 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-AzureOperationalInsightsEndpoint
Určuje koncový bod pro přístup k dotazům provozního Přehledy.
| Typ: | String |
| Position: | 22 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-AzureOperationalInsightsEndpointResourceId
Určuje cílovou skupinu pro přístupové tokeny, které autorizuje požadavky na provozní Přehledy služby.
| Typ: | String |
| Position: | 21 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-BatchEndpointResourceId
Identifikátor prostředku služby Azure Batch, která je příjemcem požadovaného tokenu
| Typ: | String |
| Aliasy: | BatchResourceId, BatchAudience |
| Position: | 20 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DataLakeAudience
Cílová skupina tokenů, které se ověřují pomocí koncového bodu služby AD Data Lake
| Typ: | String |
| Aliasy: | DataLakeEndpointResourceId, DataLakeResourceId |
| Position: | 19 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
| Typ: | IAzureContextContainer |
| Aliasy: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-EnableAdfsAuthentication
Označuje, že je povolené místní ověřování Active Directory Federation Services (AD FS) (ADFS).
| Typ: | SwitchParameter |
| Aliasy: | OnPremise |
| Position: | 16 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-GalleryEndpoint
Určuje koncový bod pro galerii šablon nasazení Azure Resource Manageru.
| Typ: | String |
| Aliasy: | Gallery, GalleryUrl |
| Position: | 7 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-GraphAudience
Cílová skupina pro tokeny ověřující pomocí koncového bodu grafu AD.
| Typ: | String |
| Aliasy: | GraphEndpointResourceId, GraphResourceId |
| Position: | 18 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-GraphEndpoint
Určuje adresu URL pro požadavky Graphu (metadata služby Active Directory).
| Typ: | String |
| Aliasy: | Graph, GraphUrl |
| Position: | 9 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ManagementPortalUrl
Určuje adresu URL portálu pro správu.
| Typ: | String |
| Position: | 3 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Name
Určuje název prostředí, které se má upravit.
| Typ: | String |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-PublishSettingsFileUrl
Určuje adresu URL, ze které lze stáhnout soubory .publishsettings.
| Typ: | String |
| Position: | 1 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ResourceManagerEndpoint
Určuje adresu URL pro požadavky Azure Resource Manageru.
| Typ: | String |
| Aliasy: | ResourceManager, ResourceManagerUrl |
| Position: | 6 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Scope
Určuje rozsah změn kontextu, například zda se změny vztahují pouze na aktuální proces, nebo na všechny relace spuštěné tímto uživatelem.
| Typ: | ContextModificationScope |
| Přípustné hodnoty: | Process, CurrentUser |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ServiceEndpoint
Určuje koncový bod pro požadavky správy služeb (RDFE).
| Typ: | String |
| Aliasy: | ServiceManagement, ServiceManagementUrl |
| Position: | 2 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-SqlDatabaseDnsSuffix
Určuje příponu názvu domény pro servery Azure SQL Database.
| Typ: | String |
| Position: | 13 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-StorageEndpoint
Určuje koncový bod pro přístup k úložišti (přístup k objektům blob, tabulce, frontě a souboru).
| Typ: | String |
| Aliasy: | StorageEndpointSuffix |
| Position: | 4 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-TrafficManagerDnsSuffix
Určuje příponu názvu domény pro služby Azure Traffic Manager.
| Typ: | String |
| Position: | 12 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |