Add-AzureEnvironment
Létrehoz egy Azure-környezetet.
Feljegyzés
A jelen dokumentációban hivatkozott parancsmagok az Azure Service Manager (ASM) API-kat használó örökölt Azure-erőforrások kezelésére szolgálnak. Ez az örökölt PowerShell-modul nem ajánlott új erőforrások létrehozásakor, mivel az ASM a kivonásra van ütemezve. További információkért lásd az Azure Service Manager kivonását.
Az Az PowerShell-modul az ajánlott PowerShell-modul az Azure Resource Manager-erőforrások PowerShell-lel való kezeléséhez.
Syntax
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
Az Add-AzureEnvironment parancsmag létrehoz egy új egyéni Azure-fiókkörnyezetet, és menti azt a központi felhasználói profilba. A parancsmag egy objektumot ad vissza, amely az új környezetet jelöli. Ha a parancs befejeződik, használhatja a környezetet a Windows PowerShellben.
Az Azure-környezet a Microsoft Azure független üzembe helyezése, például az AzureCloud a globális Azure-hoz és az Azure Azure-hoz készült AzureChinaCloud, amelyet a 21Vianet üzemeltet Kínában. Helyszíni Azure-környezeteket az Azure Pack és a WAPack parancsmagok használatával is létrehozhat. További információ: Azure Pack.
Csak a parancsmag Név paramétere kötelező. Ha kihagy egy paramétert, annak értéke null ($Null), és előfordulhat, hogy a végpontot használó szolgáltatás nem működik megfelelően. Egy környezeti tulajdonság értékének hozzáadásához vagy módosításához használja a Set-AzureEnvironment parancsmagot.
MEGJEGYZÉS: A környezet módosítása a fiók meghiúsulását okozhatja. A környezetek általában csak teszteléshez vagy hibaelhárításhoz vannak hozzáadva.
Ez a témakör a Microsoft Azure PowerShell modul 0.8.10-es verziójában található parancsmagot ismerteti.
A használt modul verziójának lekéréséhez írja be (Get-Module -Name Azure).Version
az Azure PowerShell-konzolba.
Példák
1. példa: Azure-környezet hozzáadása
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 :
Ez a parancs létrehozza a ContosoEnv Azure-környezetet.
Paraméterek
-ActiveDirectoryEndpoint
Megadja a Microsoft Entra-hitelesítés végpontot az új környezetben.
Típus: | String |
Aliasok: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-ActiveDirectoryServiceEndpointResourceId
Megadja annak a felügyeleti API-nak az erőforrás-azonosítóját, amelynek hozzáférését a Microsoft Entra ID kezeli.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-AdTenant
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-AzureKeyVaultDnsSuffix
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-AzureKeyVaultServiceEndpointResourceId
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-EnableAdfsAuthentication
Típus: | SwitchParameter |
Aliasok: | OnPremise |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-GalleryEndpoint
Megadja az Azure Resource Manager-gyűjtemény végpontját, amely erőforráscsoport-katalógussablonokat tárol. Az Azure-erőforráscsoportokról és a katalógussablonokról további információt a Get-AzureResourceGroupGalleryTemplate súgótémakörében talál.https://go.microsoft.com/fwlink/?LinkID=393052.
Típus: | String |
Aliasok: | Gallery, GalleryUrl |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-GraphEndpoint
Típus: | String |
Aliasok: | Graph, GraphUrl |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-ManagementPortalUrl
Megadja az Azure Management Portal URL-címét az új környezetben.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Name
Megadja a környezet nevét. Ez a paraméter kötelező. Ne használja az alapértelmezett környezetek, az AzureCloud és az AzureChinaCloud nevét.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Profile
Azt az Azure-profilt adja meg, amelyből a parancsmag beolvassa. Ha nem ad meg profilt, ez a parancsmag a helyi alapértelmezett profilból olvas be.
Típus: | AzureSMProfile |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-PublishSettingsFileUrl
Megadja a fiók közzétételi beállítások fájljainak URL-címét. Az Azure publish settings file egy XML-fájl, amely a fiókjával kapcsolatos információkat és egy felügyeleti tanúsítványt tartalmaz, amely lehetővé teszi a Windows PowerShell számára, hogy az Ön nevében jelentkezzen be az Azure-fiókjába.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-ResourceManagerEndpoint
Meghatározza az Azure Resource Manager-adatok végpontjait, beleértve a fiókhoz társított erőforráscsoportok adatait is. Az Azure Resource Managerrel kapcsolatos további információkért lásd: Azure Resource Manager-parancsmagok (https://go.microsoft.com/fwlink/?LinkID=394765) és a Windows PowerShell használata a Resource Managerrel (https://go.microsoft.com/fwlink/?LinkID=394767).
Típus: | String |
Aliasok: | ResourceManager, ResourceManagerUrl |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-ServiceEndpoint
Az Azure-szolgáltatásvégpont URL-címét adja meg. Az Azure szolgáltatásvégpont határozza meg, hogy az alkalmazást a globális Azure-platform, a 21Vianet által Kínában üzemeltetett Azure vagy egy privát Azure-telepítés felügyeli-e.
Típus: | String |
Aliasok: | ServiceManagement, ServiceManagementUrl |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-SqlDatabaseDnsSuffix
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-StorageEndpoint
Az új környezetben a tárolási szolgáltatások alapértelmezett végpontját adja meg.
Típus: | String |
Aliasok: | StorageEndpointSuffix |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-TrafficManagerDnsSuffix
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
None
Ehhez a parancsmaghoz a bemenetet tulajdonságnév alapján, érték alapján azonban nem lehet becsúszni.
Kimenetek
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment