Add-AzureEnvironment
Hiermee maakt u een Azure-omgeving.
Notitie
De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.
De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.
Syntaxis
Add-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
De cmdlet Add-AzureEnvironment maakt een nieuwe aangepaste Azure-accountomgeving en slaat deze op in uw zwervende gebruikersprofiel. De cmdlet retourneert een object dat de nieuwe omgeving vertegenwoordigt. Wanneer de opdracht is voltooid, kunt u de omgeving in Windows PowerShell gebruiken.
Een Azure-omgeving een onafhankelijke implementatie van Microsoft Azure, zoals AzureCloud voor wereldwijde Azure en AzureChinaCloud voor Azure beheerd door 21Vianet in China. U kunt ook on-premises Azure-omgevingen maken met behulp van Azure Pack en de WAPack-cmdlets. Zie Azure Pack voor meer informatie.
Alleen de naamparameter van deze cmdlet is verplicht. Als u een parameter weglaat, is de waarde null ($Null) en werkt de service die dat eindpunt gebruikt mogelijk niet goed. Gebruik de cmdlet Set-AzureEnvironment om de waarde van een omgevingseigenschap toe te voegen of te wijzigen.
OPMERKING: Als u uw omgeving wijzigt, kan uw account mislukken. Omgevingen worden doorgaans alleen toegevoegd voor testen of probleemoplossing.
In dit onderwerp wordt de cmdlet in de versie 0.8.10 van de Microsoft Azure PowerShell-module beschreven.
Als u de versie van de module wilt ophalen die u gebruikt, typt (Get-Module -Name Azure).Versionu in de Azure PowerShell-console.
Voorbeelden
Voorbeeld 1: Een Azure-omgeving toevoegen
PS C:\> Add-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl https://contoso.com/fwlink/?LinkID=101 -ServiceEndpoint https://contoso.com/fwlink/?LinkID=102
Name : ContosoEnv
PublishSettingsFileUrl : https://contoso.com/fwlink/?LinkID=101
ServiceEndpoint : https://contoso.com/fwlink/?LinkID=102
ResourceManagerEndpoint :
ManagementPortalUrl :
ActiveDirectoryEndpoint :
ActiveDirectoryCommonTenantId :
StorageEndpointSuffix :
StorageBlobEndpointFormat :
StorageQueueEndpointFormat :
StorageTableEndpointFormat :
GalleryEndpoint :Met deze opdracht maakt u de Azure-omgeving ContosoEnv.
Parameters
-ActiveDirectoryEndpoint
Hiermee geeft u het eindpunt voor Microsoft Entra-verificatie in de nieuwe omgeving.
| Type: | String |
| Aliassen: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ActiveDirectoryServiceEndpointResourceId
Hiermee geeft u de resource-id van een beheer-API waarvan de toegang wordt beheerd door Microsoft Entra-id.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-AdTenant
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-AzureKeyVaultDnsSuffix
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-AzureKeyVaultServiceEndpointResourceId
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-EnableAdfsAuthentication
| Type: | SwitchParameter |
| Aliassen: | OnPremise |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-GalleryEndpoint
Hiermee geeft u het eindpunt op voor de Azure Resource Manager-galerie, waarin galeriesjablonen voor resourcegroepen worden opgeslagen. Zie het Help-onderwerp voor Get-AzureResourceGroupGalleryTemplate voor meer informatie over Azure-resourcegroepen en galeriesjablonenhttps://go.microsoft.com/fwlink/?LinkID=393052.
| Type: | String |
| Aliassen: | Gallery, GalleryUrl |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-GraphEndpoint
| Type: | String |
| Aliassen: | Graph, GraphUrl |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ManagementPortalUrl
Hiermee geeft u de URL van de Azure Management Portal in de nieuwe omgeving op.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Name
Hiermee geeft u een naam voor de omgeving. Deze parameter is vereist. Gebruik niet de namen van de standaardomgevingen, AzureCloud en AzureChinaCloud.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Profile
Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-PublishSettingsFileUrl
Hiermee geeft u de URL van de publicatie-instellingenbestanden voor uw account. Een Bestand met publicatie-instellingen voor Azure is een XML-bestand met informatie over uw account en een beheercertificaat waarmee Windows PowerShell zich namens u kan aanmelden bij uw Azure-account.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ResourceManagerEndpoint
Hiermee geeft u het eindpunt voor Azure Resource Manager-gegevens op, inclusief gegevens over resourcegroepen die zijn gekoppeld aan het account. Zie Azure Resource Manager-cmdlets () en Windows PowerShell gebruiken met Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767) voor meer informatie over Azure Resource Manager.https://go.microsoft.com/fwlink/?LinkID=394765
| Type: | String |
| Aliassen: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ServiceEndpoint
Hiermee geeft u de URL van het Azure-service-eindpunt. Het Azure-service-eindpunt bepaalt of uw toepassing wordt beheerd door het wereldwijde Azure-platform, Azure beheerd door 21Vianet in China of een persoonlijke Azure-installatie.
| Type: | String |
| Aliassen: | ServiceManagement, ServiceManagementUrl |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-SqlDatabaseDnsSuffix
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-StorageEndpoint
Hiermee geeft u het standaardeindpunt van opslagservices in de nieuwe omgeving.
| Type: | String |
| Aliassen: | StorageEndpointSuffix |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-TrafficManagerDnsSuffix
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
Invoerwaarden
None
U kunt invoer naar deze cmdlet doorsluisen op eigenschapsnaam, maar niet op waarde.
Uitvoerwaarden
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment