Set-AzureEnvironment
Zmienia właściwości środowiska platformy Azure.
Uwaga
Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.
Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.
Składnia
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>]
Opis
Polecenie cmdlet Set-AzureEnvironment zmienia właściwości środowiska platformy Azure. Zwraca obiekt reprezentujący środowisko z nowymi wartościami właściwości. Użyj parametru Name , aby zidentyfikować środowisko i inne parametry, aby zmienić wartości właściwości. Nie można użyć polecenia Set-AzureEnvironment , aby zmienić nazwę środowiska platformy Azure.
Środowisko platformy Azure niezależne wdrożenie platformy Microsoft Azure, takie jak AzureCloud for global Azure i AzureChinaCloud for Azure obsługiwane przez firmę 21Vianet w Chinach. Możesz również tworzyć lokalne środowiska platformy Azure przy użyciu pakietu Azure Pack i poleceń cmdlet WAPack. Aby uzyskać więcej informacji, zobacz Azure Pack.
UWAGA: Nie zmieniaj właściwości środowisk AzureCloud lub AzureChinaCloud. Użyj tego polecenia cmdlet, aby zmienić wartości utworzonych środowisk prywatnych.
Przykłady
Przykład 1. Zmienianie właściwości środowiska
PS C:\> Set-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl "https://contoso.com" -StorageEndpoint "contoso.com"
To polecenie zmienia wartości właściwości PublishSettingsFileUrl i StorageEndpoint środowiska ContosoEnv.
Parametry
-ActiveDirectoryEndpoint
Zmienia punkt końcowy uwierzytelniania entra firmy Microsoft na określoną wartość.
Typ: | String |
Aliases: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ActiveDirectoryServiceEndpointResourceId
Określa identyfikator zasobu interfejsu API zarządzania, którego dostęp jest zarządzany przez identyfikator Entra firmy Microsoft.
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AdTenant
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AzureKeyVaultDnsSuffix
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AzureKeyVaultServiceEndpointResourceId
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EnableAdfsAuthentication
Typ: | SwitchParameter |
Aliases: | OnPremise |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-GalleryEndpoint
Zmienia punkt końcowy galerii usługi Azure Resource Manager na określoną wartość. Punkt końcowy galerii to lokalizacja szablonów galerii grup zasobów. Aby uzyskać więcej informacji na temat grup zasobów platformy Azure i szablonów galerii, zobacz temat pomocy dotyczący polecenia Get-AzureResourceGroupGalleryTemplate.
Typ: | String |
Aliases: | Gallery, GalleryUrl |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-GraphEndpoint
Typ: | String |
Aliases: | Graph, GraphUrl |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ManagementPortalUrl
Zmienia adres URL portalu zarządzania Platformy Azure na określoną wartość.
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Identyfikuje środowisko, które jest zmieniane. Ten parametr jest wymagany. W wartości parametru jest uwzględniana wielkość liter. Symbole wieloznaczne nie są dozwolone.
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.
Typ: | AzureSMProfile |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublishSettingsFileUrl
Zmienia adres URL plików ustawień publikowania w określonym środowisku. Plik ustawień publikowania platformy Azure to plik XML zawierający informacje o twoim koncie i certyfikacie zarządzania, który umożliwia programowi Windows PowerShell logowanie się do konta platformy Azure w Twoim imieniu.
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceManagerEndpoint
Zmienia punkt końcowy dla danych usługi Azure Resource Manager, w tym dane dotyczące grup zasobów skojarzonych z kontem. Aby uzyskać więcej informacji na temat usługi Azure Resource Manager, zobacz Polecenia cmdlet usługi Azure Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394765) i Używanie programu Windows PowerShell z usługą Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).
Typ: | String |
Aliases: | ResourceManager, ResourceManagerUrl |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceEndpoint
Zmienia adres URL punktu końcowego usługi platformy Azure w określonym środowisku. Punkt końcowy usługi platformy Azure określa, czy aplikacja jest zarządzana przez globalną platformę Azure, platformę Azure obsługiwaną przez firmę 21Vianet w Chinach, czy prywatną instalację platformy Azure.
Typ: | String |
Aliases: | ServiceManagement, ServiceManagementUrl |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SqlDatabaseDnsSuffix
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageEndpoint
Zmienia domyślny punkt końcowy usług magazynu w określonym środowisku.
Typ: | String |
Aliases: | StorageEndpointSuffix |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrafficManagerDnsSuffix
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Dane wejściowe
None
Możesz przekazać dane wejściowe do tego polecenia cmdlet według nazwy właściwości, ale nie według wartości.
Dane wyjściowe
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment