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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsJob
Kör cmdlet i bakgrunden
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentDebugLogLevel
Anger en felsökningsloggnivå. De acceptabla värdena för den här parametern är:
- RequestContent
- ResponseContent
- Alla
- Ingen
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | DeploymentMode |
Position: | Named |
Default value: | Incremental |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Anger namnet på resursgruppsdistributionen som ska skapas.
Type: | String |
Aliases: | DeploymentName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Anger namnet på resursgruppen som ska distribueras.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RollBackDeploymentName
Återställning till den lyckade distributionen med det angivna namnet i resursgruppen bör inte användas om -RollbackToLastDeployment används.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RollbackToLastDeployment
Återställning till den senaste lyckade distributionen i resursgruppen bör inte finnas om -RollBackDeploymentName används.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterUri
Anger URI för en mallparametrarfil.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
None
Utdata
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment