Udostępnij za pośrednictwem


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