Get-AzTemplateSpec
Pobiera lub wyświetla specyfikacje szablonu
Składnia
ListTemplateSpecsParameterSet (domyślnie)
Get-AzTemplateSpec
[[-ResourceGroupName] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetTemplateSpecByNameParameterSet
Get-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
[[-Version] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetTemplateSpecByIdParameterSet
Get-AzTemplateSpec
[[-Version] <String>]
[-ResourceId] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Opis
To polecenie cmdlet może służyć do wyświetlania listy specyfikacji szablonu w subskrypcji/grupie zasobów lub uzyskania określonej specyfikacji szablonu według nazwy lub identyfikatora. W przypadku pobierania określonej specyfikacji szablonu według nazwy/identyfikatora można opcjonalnie pobrać określoną wersję, określając nazwę wersji za pomocą parametru -Version . Jeśli jest używana opcja -Version , w *będą obecne tylko szczegółowe informacje o wersji. Wersje zwróconego obiektu specyfikacji szablonu. Jeśli nie określono określonej wersji podczas pobierania specyfikacji szablonu według nazwy/identyfikatora, wszystkie wersje będą obecne w *. Właściwość versions zwracanego obiektu.
Uwaga: podczas wyświetlania listy wszystkich specyfikacji szablonu w ramach subskrypcji lub grupy zasobów każda zwróciła specyfikację szablonu ". Właściwość versions" będzie mieć wartość null. Informacje o wersji są uwzględniane tylko wtedy, gdy podano parametry -Name lub -ResourceId (np. żądasz określonej specyfikacji/wersji szablonu).
Przykłady
Przykład 1. Wyświetlanie specyfikacji szablonu listy w bieżącej subskrypcji
Get-AzTemplateSpec
Wyświetla listę wszystkich specyfikacji szablonu w bieżącej subskrypcji.
Przykład 2. Wyświetlanie listy specyfikacji szablonu w grupie zasobów
Get-AzTemplateSpec -ResourceGroupName 'myRG'
Wyświetla listę wszystkich specyfikacji szablonu w grupie zasobów "myRG" bieżącej subskrypcji.
Przykład 3. Pobieranie specyfikacji szablonu (ze wszystkimi wersjami) według nazwy
Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec'
Pobiera informacje o specyfikacji szablonu o nazwie "MyTemplateSpec" w grupie zasobów "myRG".
Uwaga: wszystkie wersje specyfikacji szablonu będą obecne w obiekcie ". Właściwość versions" obiektu zwracanego.
Przykład 4. Pobieranie specyfikacji szablonu (określonej wersji) według nazwy
Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec' -Version 'v1.0'
Pobiera informacje o wersji "v1.0" specyfikacji szablonu o nazwie "MyTemplateSpec" w grupie zasobów "myRG".
Uwaga: ". Właściwość versions" zwróconego obiektu będzie zawierać tylko żądaną wersję.
Przykład 5. Pobieranie specyfikacji szablonu (ze wszystkimi wersjami) według identyfikatora zasobu
Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec'
Pobiera informacje o specyfikacji szablonu o nazwie "MyTemplateSpec" w grupie zasobów "myRG" subskrypcji {subId}.
Uwaga: wszystkie wersje specyfikacji szablonu będą obecne w obiekcie ". Właściwość versions" obiektu zwracanego.
Przykład 6. Pobieranie specyfikacji szablonu (określonej wersji) według identyfikatora zasobu
Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec' -Version 'v1.0'
Pobiera informacje o wersji "v1.0" specyfikacji szablonu o nazwie "MyTemplateSpec" w grupie zasobów "myRG" subskrypcji {subId}.
Uwaga: ". Właściwość versions" zwróconego obiektu będzie zawierać tylko żądaną wersję.
Parametry
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Właściwości parametru
| Typ: | IAzureContextContainer |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | AzContext, AzureRmContext, AzureCredential |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Name
Nazwa specyfikacji szablonu.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
GetTemplateSpecByNameParameterSet
| Position: | 1 |
| Obowiązkowe: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-ResourceGroupName
Nazwa grupy zasobów.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ListTemplateSpecsParameterSet
| Position: | 0 |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-ResourceId
W pełni kwalifikowany identyfikator zasobu specyfikacji szablonu. Przykład: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Id |
Zestawy parametrów
GetTemplateSpecByIdParameterSet
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Version
Wersja specyfikacji szablonu.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
GetTemplateSpecByNameParameterSet
| Position: | 2 |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
GetTemplateSpecByIdParameterSet
| Position: | 2 |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
