Add-AzureEnvironment
Vytvoří 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.
Syntaxe
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
Rutina Add-AzureEnvironment vytvoří nové vlastní prostředí účtu Azure a uloží ho do vašeho cestovního profilu uživatele. Rutina vrátí objekt, který představuje nové prostředí. Po dokončení příkazu můžete prostředí použít ve Windows PowerShellu.
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.
Povinný je pouze parametr Name této rutiny. Pokud parametr vynecháte, jeho hodnota je null ($Null) a služba, která používá tento koncový bod, nemusí správně fungovat. Pokud chcete přidat nebo změnit hodnotu vlastnosti prostředí, použijte rutinu Set-AzureEnvironment .
POZNÁMKA: Změna prostředí může způsobit selhání účtu. Prostředí se obvykle přidávají jenom pro účely testování nebo řešení potíží.
Toto téma popisuje rutinu ve verzi 0.8.10 modulu Microsoft Azure PowerShell.
Pokud chcete získat verzi modulu, který používáte, zadejte (Get-Module -Name Azure).Versionv konzole Azure PowerShellu .
Příklady
Příklad 1: Přidání prostředí Azure
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 :Tento příkaz vytvoří prostředí Azure ContosoEnv.
Parametry
-ActiveDirectoryEndpoint
Určuje koncový bod pro ověřování Microsoft Entra v novém prostředí.
| Typ: | String |
| Aliasy: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ActiveDirectoryServiceEndpointResourceId
Určuje ID prostředku rozhraní API pro správu, jehož přístup spravuje Microsoft Entra ID.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-AdTenant
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-AzureKeyVaultDnsSuffix
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-AzureKeyVaultServiceEndpointResourceId
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-EnableAdfsAuthentication
| Typ: | SwitchParameter |
| Aliasy: | OnPremise |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-GalleryEndpoint
Určuje koncový bod galerie Azure Resource Manageru, do kterého se ukládají š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.https://go.microsoft.com/fwlink/?LinkID=393052.
| Typ: | String |
| Aliasy: | Gallery, GalleryUrl |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-GraphEndpoint
| Typ: | String |
| Aliasy: | Graph, GraphUrl |
| Position: | Named |
| 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 Azure v novém prostředí.
| Typ: | String |
| Position: | Named |
| 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í. Tento parametr je povinný. Nepoužívejte názvy výchozích prostředí, AzureCloudu a AzureChinaCloudu.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PublishSettingsFileUrl
Určuje adresu URL souborů nastavení publikování pro váš účet. 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 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ResourceManagerEndpoint
Určuje 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 |
| Aliasy: | ResourceManager, ResourceManagerUrl |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ServiceEndpoint
Určuje adresu URL koncového bodu služby Azure. 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 |
| Aliasy: | ServiceManagement, ServiceManagementUrl |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-SqlDatabaseDnsSuffix
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-StorageEndpoint
Určuje výchozí koncový bod služeb úložiště v novém prostředí.
| Typ: | String |
| Aliasy: | StorageEndpointSuffix |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-TrafficManagerDnsSuffix
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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