New-AzureRmResourceGroupDeployment
Lägger till en Azure-distribution till en resursgrupp.
Varning
AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.
Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.
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
Cmdleten New-AzureRmResourceGroupDeployment lägger till en distribution till en befintlig resursgrupp. Detta omfattar de resurser som krävs för distributionen. En Azure-resurs är en användarhanterad Azure-entitet, till exempel en databasserver, databas, webbplats, virtuell dator eller lagringskonto. En Azure-resursgrupp är en samling Azure-resurser som distribueras som en enhet, till exempel den webbplats, databasserver och databaser som krävs för en finansiell webbplats. En resursgruppsdistribution använder en mall för att lägga till resurser i en resursgrupp och publicerar dem så att de är tillgängliga i Azure. Om du vill lägga till resurser i en resursgrupp utan att använda en mall använder du cmdleten New-AzureRmResource. Om du vill lägga till en resursgruppsdistribution anger du namnet på en befintlig resursgrupp och en resursgruppsmall. En resursgruppsmall är en JSON-sträng som representerar en resursgrupp för en komplex molnbaserad tjänst, till exempel en webbportal. Mallen innehåller platshållare för parametrar för nödvändiga resurser och konfigurerbara egenskapsvärden, till exempel namn och storlekar. Du hittar många mallar i Azure-mallgalleriet eller så kan du skapa egna mallar. Du kan använda cmdleten Get-AzureRmResourceGroupGalleryTemplate för att hitta en mall i galleriet. Om du vill använda en anpassad mall för att skapa en resursgrupp anger du parametern TemplateFile eller parametern TemplateUri . Varje mall har parametrar för konfigurerbara egenskaper. Om du vill ange värden för mallparametrarna anger du parametern TemplateParameterFile eller parametern TemplateParameterObject . Du kan också använda mallparametrarna som läggs till dynamiskt i kommandot när du anger en mall. Om du vill använda dynamiska parametrar skriver du dem i kommandotolken eller skriver ett minustecken (-) för att ange en parameter och använder tabbnyckeln för att bläddra igenom tillgängliga parametrar. Mallparametervärden som du anger i kommandotolken har företräde framför värden i ett mallparameterobjekt eller en fil.
Exempel
Exempel 1: Använd en anpassad mall och parameterfil för att skapa en distribution
PS C:\>New-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json"Det här kommandot skapar en ny distribution med hjälp av en anpassad mall och en mallfil på disken. Kommandot använder parametern TemplateFile för att ange mallen och parametern TemplateParameterFile för att ange en fil som innehåller parametrar och parametervärden.
Parametrar
-ApiVersion
Anger den API-version som stöds av resursprovidern. Du kan ange en annan version än standardversionen.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-AsJob
Kör cmdlet i bakgrunden
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
| Typ: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure
| Typ: | IAzureContextContainer |
| Alias: | AzureRmContext, AzureCredential |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-DeploymentDebugLogLevel
Anger en felsökningsloggnivå. De acceptabla värdena för den här parametern är:
- RequestContent
- ResponseContent
- Alla
- Ingen
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Mode
Anger distributionsläget. De acceptabla värdena för den här parametern är:
- Klart
- Inkrementellt I fullständigt läge tar Resource Manager bort resurser som finns i resursgruppen men som inte anges i mallen. I inkrementellt läge lämnar Resource Manager oförändrade resurser som finns i resursgruppen men som inte anges i mallen.
| Typ: | DeploymentMode |
| Position: | Named |
| Standardvärde: | Incremental |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Name
Anger namnet på resursgruppsdistributionen som ska skapas.
| Typ: | String |
| Alias: | DeploymentName |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Pre
Anger att den här cmdleten tar hänsyn till förhandsversioner av API:et när den automatiskt avgör vilken version som ska användas.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ResourceGroupName
Anger namnet på resursgruppen som ska distribueras.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-RollBackDeploymentName
Återställning till den lyckade distributionen med det angivna namnet i resursgruppen bör inte användas om -RollbackToLastDeployment används.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-RollbackToLastDeployment
Återställning till den senaste lyckade distributionen i resursgruppen bör inte finnas om -RollBackDeploymentName används.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-TemplateFile
Anger den fullständiga sökvägen till en JSON-mallfil. Detta kan vara en anpassad mall eller en gallerimall som sparas som en JSON-fil, till exempel en som skapas med hjälp av cmdleten Save-AzureRmResourceGroupGalleryTemplate .
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-TemplateParameterFile
Anger den fullständiga sökvägen till en JSON-fil som innehåller namn och värden för mallparametrarna. Om en mall har parametrar måste du ange parametervärdena med parametern TemplateParameterFile eller parametern TemplateParameterObject . Mallparametrar läggs till dynamiskt i kommandot när du anger en mall. Om du vill använda dynamiska parametrar skriver du ett minustecken (-) för att ange ett parameternamn och använder sedan tabbnyckeln för att bläddra igenom de tillgängliga parametrarna.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-TemplateParameterObject
Anger en hash-tabell med mallparameternamn och -värden.
Om du vill ha hjälp med hash-tabeller i Windows PowerShell skriver du Get-Help about_Hash_Tables.
Om en mall har parametrar måste du ange parametervärden.
Mallparametrar läggs till dynamiskt i kommandot när du anger en mall.
| Typ: | Hashtable |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-TemplateParameterUri
Anger URI för en mallparametrarfil.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-TemplateUri
Anger URI för en JSON-mallfil. Den här filen kan vara en anpassad mall eller en gallerimall som sparas som en JSON-fil, till exempel genom att använda Save-AzureRmResourceGroupGalleryTemplate.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
| Typ: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Standardvärde: | False |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
Indata
None
Utdata
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment