Set-AzureEnvironment
Změní vlastnosti prostředí Azure.
Poznámka:
Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.
Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.
Syntax
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>] Description
Rutina Set-AzureEnvironment změní vlastnosti prostředí Azure. Vrátí objekt, který představuje prostředí s jeho novými hodnotami vlastností. Pomocí parametru Name identifikujte prostředí a další parametry ke změně hodnot vlastností. Ke změně názvu prostředí Azure nemůžete použít Set-AzureEnvironment .
Prostředí Azure nezávislé nasazení Microsoft Azure, jako je AzureCloud pro globální Azure a AzureChinaCloud pro Azure provozované společností 21Vianet v Číně. Místní prostředí Azure můžete vytvořit také pomocí azure Packu a rutin WAPacku. Další informace najdete v tématu Azure Pack.
POZNÁMKA: Neměňte vlastnosti prostředí AzureCloud ani AzureChinaCloud. Pomocí této rutiny můžete změnit hodnoty privátních prostředí, která vytvoříte.
Příklady
Příklad 1: Změna vlastností prostředí
PS C:\> Set-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl "https://contoso.com" -StorageEndpoint "contoso.com"Tento příkaz změní hodnoty vlastností PublishSettingsFileUrl a StorageEndpoint prostředí ContosoEnv.
Parametry
-ActiveDirectoryEndpoint
Změní koncový bod pro ověřování Microsoft Entra na zadanou hodnotu.
| Typ: | String |
| Aliases: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ActiveDirectoryServiceEndpointResourceId
Určuje ID prostředku rozhraní API pro správu, jehož přístup spravuje Microsoft Entra ID.
| Typ: | String |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AdTenant
| Typ: | String |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureKeyVaultDnsSuffix
| Typ: | String |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureKeyVaultServiceEndpointResourceId
| Typ: | String |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EnableAdfsAuthentication
| Typ: | SwitchParameter |
| Aliases: | OnPremise |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryEndpoint
Změní koncový bod galerie Azure Resource Manageru na zadanou hodnotu. Koncový bod galerie je umístění pro šablony galerie skupin prostředků. Další informace o skupinách prostředků Azure a šablonách galerie najdete v tématu nápovědy k rutině Get-AzureResourceGroupGalleryTemplate.
| Typ: | String |
| Aliases: | Gallery, GalleryUrl |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GraphEndpoint
| Typ: | String |
| Aliases: | Graph, GraphUrl |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ManagementPortalUrl
Změní adresu URL portálu pro správu Azure na zadanou hodnotu.
| Typ: | String |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Identifikuje prostředí, které se mění. Tento parametr je povinný. V hodnotě parametru se rozlišují malá a velká písmena. Zástupné znaky nejsou povoleny.
| Typ: | String |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Profile
Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.
| Typ: | AzureSMProfile |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublishSettingsFileUrl
Změní adresu URL pro soubory nastavení publikování v zadaném prostředí. Soubor nastavení publikování Azure je soubor XML, který obsahuje informace o vašem účtu a certifikát pro správu, který umožňuje Windows PowerShellu přihlásit se k vašemu účtu Azure vaším jménem.
| Typ: | String |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceManagerEndpoint
Změní koncový bod pro data Azure Resource Manageru, včetně dat o skupinách prostředků přidružených k účtu. Další informace o Azure Resource Manageru najdete v tématu Rutiny Azure Resource Manageru (https://go.microsoft.com/fwlink/?LinkID=394765) a Použití Prostředí Windows PowerShell s Resource Managerem (https://go.microsoft.com/fwlink/?LinkID=394767).
| Typ: | String |
| Aliases: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ServiceEndpoint
Změní adresu URL koncového bodu služby Azure v zadaném prostředí. Koncový bod služby Azure určuje, jestli je vaše aplikace spravovaná globální platformou Azure, Azure provozovanou společností 21Vianet v Číně nebo privátní instalací Azure.
| Typ: | String |
| Aliases: | ServiceManagement, ServiceManagementUrl |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SqlDatabaseDnsSuffix
| Typ: | String |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageEndpoint
Změní výchozí koncový bod služeb úložiště v zadaném prostředí.
| Typ: | String |
| Aliases: | StorageEndpointSuffix |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TrafficManagerDnsSuffix
| Typ: | String |
| Position: | Named |
| výchozí hodnota: | None |
| Vyžadováno: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Vstupy
None
Vstup do této rutiny můžete řadit podle názvu vlastnosti, ale ne podle hodnoty.
Výstupy
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment