Export-AzResourceGroup
Zachytí skupinu prostředků jako šablonu a uloží ji do souboru.
Syntaxe
Export-AzResourceGroup
-ResourceGroupName <String>
[-Path <String>]
[-IncludeParameterDefaultValue]
[-IncludeComments]
[-SkipResourceNameParameterization]
[-SkipAllParameterization]
[-Resource <String[]>]
[-Force]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Export-AzResourceGroup zachytí zadanou skupinu prostředků jako šablonu a uloží ji do souboru JSON. To může být užitečné ve scénářích, kdy jste už vytvořili některé prostředky ve skupině prostředků a pak chcete využít výhody použití nasazení založených na šablonách. Tato rutina vám umožní snadno začít generováním šablony pro existující prostředky ve skupině prostředků. V některých případech se může stát, že se této rutině nepodaří vygenerovat některé části šablony. Zprávy s upozorněním vás informují o prostředcích, které selhaly. Šablona se bude dál generovat pro části, které byly úspěšné.
Příklady
Příklad 1: Export skupiny prostředků
Export-AzResourceGroup -ResourceGroupName "TestGroup"
Tento příkaz zachytí skupinu prostředků s názvem TestGroup jako šablonu a uloží ji do souboru JSON v aktuálním adresáři.
Příklad 2: Export jednoho prostředku ze skupiny prostředků
Export-AzResourceGroup -ResourceGroupName "TestGroup" -Resource "/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Compute/virtualMachines/TestVirtualMachine"
Tento příkaz zachytí prostředek virtuálního počítače s názvem TestVirtualMachine ze skupiny prostředků TestGroup jako šablonu a uloží ho do souboru JSON v aktuálním adresáři.
Příklad 3: Export výběru prostředků ze skupiny prostředků
Export-AzResourceGroup -ResourceGroupName "TestGroup" -SkipAllParameterization -Resource @(
"/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Compute/virtualMachines/TestVm",
"/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Network/networkInterfaces/TestNic"
)
Tento příkaz zachytí dva prostředky ze skupiny prostředků TestGroup jako šablonu a uloží ho do souboru JSON v aktuálním adresáři. Vygenerovaná šablona nebude obsahovat žádné vygenerované parametry.
Parametry
-ApiVersion
Určuje verzi rozhraní API poskytovatele prostředků, která se má použít. Pokud není zadáno, použije se nejnovější verze rozhraní API.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Force
Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-IncludeComments
Označuje, že tato operace exportuje šablonu s komentáři.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-IncludeParameterDefaultValue
Označuje, že tato operace exportuje parametr šablony s výchozí hodnotou.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Path
Určuje výstupní cestu k souboru šablony.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Pre
Označuje, že tato rutina používá předběžné verze rozhraní API při automatickém určení verze rozhraní API, která má být používána.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Resource
Seznam id prostředků pro filtrování výsledků.
Typ: | String[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ResourceGroupName
Určuje název skupiny prostředků, která se má exportovat.
Typ: | String |
Aliasy: | ResourceGroup |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-SkipAllParameterization
Přeskočte veškerou parametrizaci.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-SkipResourceNameParameterization
Přeskočte parametrizaci názvu prostředku.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |