Get-AzTemplateSpec
Pobiera lub wyświetla specyfikacje szablonu
Składnia
Get-AzTemplateSpec
[[-ResourceGroupName] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
[[-Version] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
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.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Name
Nazwa specyfikacji szablonu.
Typ: | String |
Position: | 1 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Nazwa grupy zasobów.
Typ: | String |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-ResourceId
W pełni kwalifikowany identyfikator zasobu specyfikacji szablonu. Przykład: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}
Typ: | String |
Aliasy: | Id |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Version
Wersja specyfikacji szablonu.
Typ: | String |
Position: | 2 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |