Auf Englisch lesen

Freigeben über


Get-AzTemplateSpec

Abrufen oder Auflisten von Vorlagenspezifikationen

Syntax

PowerShell
Get-AzTemplateSpec
   [[-ResourceGroupName] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
PowerShell
Get-AzTemplateSpec
   [-ResourceGroupName] <String>
   [-Name] <String>
   [[-Version] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
PowerShell
Get-AzTemplateSpec
   [[-Version] <String>]
   [-ResourceId] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Dieses Cmdlet kann verwendet werden, um Vorlagenspezifikationen in einer Abonnement-/Ressourcengruppe aufzulisten oder eine bestimmte Vorlagenspezifikation anhand des Namens oder der ID abzurufen. Wenn Sie eine bestimmte Vorlagenspezifikation nach Name/ID abrufen, kann optional eine bestimmte Version abgerufen werden, indem Sie einen Versionsnamen über den Parameter -Version angeben. Wenn -Version verwendet wird, sind nur die spezifischen Versionsdetails in *vorhanden. Versionen für das zurückgegebene Template Spec-Objekt. Wenn beim Abrufen einer Vorlagenspezifikation keine bestimmte Version anhand des Namens/der ID angegeben wird, sind alle Versionen im *vorhanden. Versions Eigenschaft des zurückgegebenen Objekts.

Hinweis: Wenn sie alle Vorlagenspezifikationen in einem Abonnement oder einer Ressourcengruppe auflisten, wird jedes zurückgegebene Vorlagenspezifikations-". Versions" Eigenschaft wird NULL-. Versionsinformationen sind nur enthalten, wenn -Name- oder -ResourceId Parameter bereitgestellt werden (z. B.: Sie fordern eine bestimmte Vorlagenspezifikation/Version an).

Beispiele

Beispiel 1: Listenvorlagenspezifikationen im aktuellen Abonnement

PowerShell
Get-AzTemplateSpec

Listet alle Vorlagenspezifikationen im aktuellen Abonnement auf.

Beispiel 2: Listenvorlagenspezifikationen in einer Ressourcengruppe

PowerShell
Get-AzTemplateSpec -ResourceGroupName 'myRG'

Listet alle Vorlagenspezifikationen in der Ressourcengruppe "myRG" des aktuellen Abonnements auf.

Beispiel 3: Abrufen der Vorlagenspezifikation (mit allen Versionen) anhand des Namens

PowerShell
Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec'

Ruft Informationen über die Vorlagenspezifikation mit dem Namen "MyTemplateSpec" in der Ressourcengruppe "myRG" ab.

Hinweis: Alle Versionen der Vorlagenspezifikation sind im "vorhanden. Versions" -Eigenschaft des Rückgabeobjekts.

Beispiel 4: Abrufen der Vorlagenspezifikation (spezifische Version) anhand des Namens

PowerShell
Get-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'MyTemplateSpec' -Version 'v1.0'

Ruft Informationen zur Version 'v1.0' der Vorlagenspezifikation mit dem Namen 'MyTemplateSpec' in der Ressourcengruppe 'myRG' ab.

Hinweis: Die ". Versions" Eigenschaft des zurückgegebenen Objekts enthält nur die angeforderte version.

Beispiel 5: Abrufen der Vorlagenspezifikation (mit allen Versionen) nach Ressourcen-ID

PowerShell
Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec'

Ruft Informationen zur Vorlagenspezifikation mit dem Namen "MyTemplateSpec" in der Ressourcengruppe "myRG" des Abonnements "{subId}" ab.

Hinweis: Alle Versionen der Vorlagenspezifikation sind im "vorhanden. Versions" -Eigenschaft des Rückgabeobjekts.

Beispiel 6: Abrufen der Vorlagenspezifikation (spezifische Version) nach Ressourcen-ID

PowerShell
Get-AzTemplateSpec -ResourceId '/subscriptions/{subId}/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/MyTemplateSpec' -Version 'v1.0'

Ruft Informationen zur Version 'v1.0' der Vorlagenspezifikation mit dem Namen 'MyTemplateSpec' in der Ressourcengruppe 'myRG' des Abonnements {subId} ab.

Hinweis: Die ". Versions" Eigenschaft des zurückgegebenen Objekts enthält nur die angeforderte version.

Parameter

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Der Name der Vorlagenspezifikation.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Der Name der Ressourcengruppe.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceId

Die vollqualifizierte Ressourcen-ID der Vorlagenspezifikation. Beispiel: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}

Typ:String
Aliase:Id
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Version

Die Version der Vorlagenspezifikation.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

Ausgaben