Udostępnij za pośrednictwem

Export-AzResourceGroup

  • Odwołanie
Moduł:
Az.Resources

Przechwytuje grupę zasobów jako szablon i zapisuje ją w pliku.

Składnia

Export-AzResourceGroup
      -ResourceGroupName <String>
      [-Path <String>]
      [-IncludeParameterDefaultValue]
      [-IncludeComments]
      [-SkipResourceNameParameterization]
      [-SkipAllParameterization]
      [-Resource <String[]>]
      [-Force]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Export-AzResourceGroup przechwytuje określoną grupę zasobów jako szablon i zapisuje ją w pliku JSON. Może to być przydatne w scenariuszach, w których utworzono już niektóre zasoby w grupie zasobów, a następnie chcesz wykorzystać korzyści wynikające z używania wdrożeń opartych na szablonach. To polecenie cmdlet umożliwia łatwe rozpoczęcie od wygenerowania szablonu dla istniejących zasobów w grupie zasobów. W niektórych przypadkach nie można wygenerować niektórych części szablonu tego polecenia cmdlet. Komunikaty ostrzegawcze informują o zasobach, które zakończyły się niepowodzeniem. Szablon będzie nadal generowany dla części, które zakończyły się pomyślnie.

Przykłady

Przykład 1. Eksportowanie grupy zasobów

Export-AzResourceGroup -ResourceGroupName "TestGroup"

To polecenie przechwytuje grupę zasobów o nazwie TestGroup jako szablon i zapisuje ją w pliku JSON w bieżącym katalogu.

Przykład 2. Eksportowanie pojedynczego zasobu z grupy zasobów

Export-AzResourceGroup -ResourceGroupName "TestGroup" -Resource "/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Compute/virtualMachines/TestVirtualMachine"

To polecenie przechwytuje zasób maszyny wirtualnej o nazwie "TestVirtualMachine" z grupy zasobów "TestGroup" jako szablon i zapisuje go w pliku JSON w bieżącym katalogu.

Przykład 3. Eksportowanie wybranych zasobów z grupy zasobów

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"
)

To polecenie przechwytuje dwa zasoby z grupy zasobów "TestGroup" jako szablon i zapisuje je w pliku JSON w bieżącym katalogu. Wygenerowany szablon nie będzie zawierać żadnych wygenerowanych parametrów.

Parametry

-ApiVersion

Określa wersję interfejsu API dostawcy zasobów do użycia. Jeśli nie zostanie określona, zostanie użyta najnowsza wersja interfejsu API.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IncludeComments

Wskazuje, że ta operacja eksportuje szablon z komentarzami.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IncludeParameterDefaultValue

Wskazuje, że ta operacja eksportuje parametr szablonu z wartością domyślną.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Path

Określa ścieżkę wyjściową pliku szablonu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Pre

Wskazuje, że to polecenie cmdlet używa wersji interfejsu API w wersji wstępnej podczas automatycznego określania wersji interfejsu API do użycia.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Resource

Lista identyfikatorów zasobów do filtrowania wyników według.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określa nazwę grupy zasobów do wyeksportowania.

Typ:String
Aliasy:ResourceGroup
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SkipAllParameterization

Pomiń wszystkie parametryzację.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SkipResourceNameParameterization

Pomiń parametryzacja nazwy zasobu.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Dane wyjściowe

PSObject