New-AzureRmResourceGroupDeployment
Azure-telepítést ad hozzá egy erőforráscsoporthoz.
Figyelmeztetés
Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.
Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.
Syntax
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterFile <String>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterFile <String>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterUri <String>
-TemplateFile <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateParameterUri <String>
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmResourceGroupDeployment
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-DeploymentDebugLogLevel <String>]
[-RollbackToLastDeployment]
[-RollBackDeploymentName <String>]
[-Force]
[-AsJob]
-TemplateUri <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A New-AzureRmResourceGroupDeployment parancsmag üzembe helyezést ad hozzá egy meglévő erőforráscsoporthoz. Ide tartoznak az üzembe helyezéshez szükséges erőforrások. Az Azure-erőforrások felhasználó által felügyelt Azure-entitások, például adatbázis-kiszolgáló, adatbázis, webhely, virtuális gép vagy Storage-fiók. Az Azure-erőforráscsoportok olyan Azure-erőforrások gyűjteményei, amelyek egységként vannak üzembe helyezve, például a webhely, az adatbázis-kiszolgáló és a pénzügyi webhelyekhez szükséges adatbázisok. Az erőforráscsoportok üzembe helyezése sablonnal adja hozzá az erőforrásokat egy erőforráscsoporthoz, és közzéteszi őket, hogy elérhetők legyenek az Azure-ban. Ha sablon használata nélkül szeretne erőforrásokat hozzáadni egy erőforráscsoporthoz, használja a New-AzureRmResource parancsmagot. Erőforráscsoport-telepítés hozzáadásához adja meg egy meglévő erőforráscsoport és egy erőforráscsoport-sablon nevét. Az erőforráscsoport-sablon egy olyan JSON-sztring, amely egy összetett felhőalapú szolgáltatás, például egy webportál erőforráscsoportját jelöli. A sablon paraméterhelyőrzőket tartalmaz a szükséges erőforrásokhoz és konfigurálható tulajdonságértékekhez, például nevekhez és méretekhez. Számos sablont találhat az Azure-sablongyűjteményben, vagy létrehozhat saját sablonokat. A Get-AzureRmResourceGroupGalleryTemplate parancsmaggal sablont kereshet a katalógusban. Ha egyéni sablont szeretne használni egy erőforráscsoport létrehozásához, adja meg a TemplateFile paramétert vagy a TemplateUri paramétert. Minden sablon paraméterekkel rendelkezik a konfigurálható tulajdonságokhoz. A sablonparaméterek értékeinek megadásához adja meg a TemplateParameterFile paramétert vagy a TemplateParameterObject paramétert . Másik lehetőségként használhatja azokat a sablonparamétereket, amelyek dinamikusan hozzáadódnak a parancshoz egy sablon megadásakor. Dinamikus paraméterek használatához írja be őket a parancssorba, vagy írjon be egy mínuszjelet (-) egy paraméter jelzéséhez, és a Tab billentyűvel válthat az elérhető paraméterek között. A parancssorban megadott sablonparaméter-értékek elsőbbséget élveznek a sablonparaméter objektumában vagy fájljában lévő értékekkel szemben.
Példák
1. példa: Üzembe helyezés létrehozása egyéni sablon és paraméterfájl használatával
PS C:\>New-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json"
Ez a parancs létrehoz egy új üzembe helyezést egy egyéni sablon és egy sablonfájl használatával a lemezen. A parancs a TemplateFile paraméterrel adja meg a sablont és a TemplateParameterFile paramétert egy olyan fájl megadásához, amely paramétereket és paraméterértékeket tartalmaz.
Paraméterek
-ApiVersion
Az erőforrás-szolgáltató által támogatott API-verziót adja meg. Az alapértelmezett verziótól eltérő verziót is megadhat.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-AsJob
Parancsmag futtatása a háttérben
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés
Típus: | IAzureContextContainer |
Aliasok: | AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DeploymentDebugLogLevel
Hibakeresési naplószintet ad meg. A paraméter elfogadható értékei a következők:
- RequestContent
- ResponseContent
- Mind
- Egyik sem
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Force
Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Mode
Az üzembehelyezési módot adja meg. A paraméter elfogadható értékei a következők:
- Kész
- Növekményes teljes módban a Resource Manager törli az erőforráscsoportban található, de a sablonban nem megadott erőforrásokat. Növekményes módban a Resource Manager változatlan erőforrásokat hagy az erőforráscsoportban, de nincsenek megadva a sablonban.
Típus: | DeploymentMode |
Position: | Named |
Alapértelmezett érték: | Incremental |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Name
Megadja a létrehozni kívánt erőforráscsoport-telepítés nevét.
Típus: | String |
Aliasok: | DeploymentName |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Pre
Azt jelzi, hogy ez a parancsmag a kiadás előtti API-verziókat veszi figyelembe, amikor automatikusan meghatározza a használni kívánt verziót.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ResourceGroupName
Megadja az üzembe helyezni kívánt erőforráscsoport 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 |
-RollBackDeploymentName
Ha a -RollbackToLastDeployment nevet használja, ne használja a sikeres üzembe helyezést az erőforráscsoportban megadott névvel.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-RollbackToLastDeployment
Az erőforráscsoport utolsó sikeres üzembe helyezésének visszaállítása nem lehet jelen a -RollBackDeploymentName használata esetén.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-TemplateFile
Egy JSON-sablonfájl teljes elérési útját adja meg. Ez lehet egy egyéni sablon vagy egy JSON-fájlként mentett katalógussablon, például a Save-AzureRmResourceGroupGalleryTemplate parancsmaggal létrehozott sablon.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-TemplateParameterFile
Megadja a sablonparaméterek nevét és értékeit tartalmazó JSON-fájl teljes elérési útját. Ha egy sablon paraméterekkel rendelkezik, meg kell adnia a paraméterértékeket a TemplateParameterFile paraméterrel vagy a TemplateParameterObject paraméterrel. A sablonparaméterek dinamikusan hozzáadódnak a parancshoz egy sablon megadásakor. A dinamikus paraméterek használatához írjon be egy mínuszjelet (-) egy paraméternév jelzéséhez, majd a Tab billentyűvel lépegetjen a rendelkezésre álló paraméterek között.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-TemplateParameterObject
A sablonparaméterek neveit és értékeit tartalmazó kivonattáblát adja meg.
Ha segítségre van szüksége a Windows PowerShell kivonattábláival kapcsolatban, írja be a következőt Get-Help about_Hash_Tables
: .
Ha egy sablon paraméterekkel rendelkezik, paraméterértékeket kell megadnia.
A sablonparaméterek dinamikusan hozzáadódnak a parancshoz egy sablon megadásakor.
Típus: | Hashtable |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-TemplateParameterUri
Egy sablonparaméterfájl URI-ját adja meg.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-TemplateUri
Egy JSON-sablonfájl URI-ját adja meg. Ez a fájl lehet egy egyéni sablon vagy egy JSON-fájlként mentett katalógussablon, például a Save-AzureRmResourceGroupGalleryTemplate használatával.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
None
Kimenetek
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment