Udostępnij za pośrednictwem


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

Dane wejściowe

String

Dane wyjściowe

PSTemplateSpec