New-AzBlueprintArtifact
Erstellen Sie ein neues Artefakt, und speichern Sie es in einer Blueprintdefinition.
Syntax
New-AzBlueprintArtifact
-Name <String>
-Type <PSArtifactKind>
-Blueprint <PSBlueprintBase>
[-Description <String>]
[-DependsOn <System.Collections.Generic.List`1[System.String]>]
-TemplateParameterFile <String>
-TemplateFile <String>
[-ResourceGroupName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzBlueprintArtifact
-Name <String>
-Blueprint <PSBlueprintBase>
-ArtifactFile <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzBlueprintArtifact
-Name <String>
-Type <PSArtifactKind>
-Blueprint <PSBlueprintBase>
[-Description <String>]
[-DependsOn <System.Collections.Generic.List`1[System.String]>]
-RoleDefinitionId <String>
-RoleDefinitionPrincipalId <String[]>
[-ResourceGroupName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzBlueprintArtifact
-Name <String>
-Type <PSArtifactKind>
-Blueprint <PSBlueprintBase>
[-Description <String>]
[-DependsOn <System.Collections.Generic.List`1[System.String]>]
-PolicyDefinitionId <String>
-PolicyDefinitionParameter <Hashtable>
[-ResourceGroupName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Erstellen Sie ein neues Artefakt. Es gibt zwei Möglichkeiten zum Erstellen eines Artefakts: entweder über ein Artefakt-JSON als Eingabedatei oder durch Die Bereitstellung von Inlineparametern für das Artefakt. Während die JSON-Methode keinen Typ des Artefakts erfordert, dass die Inlineparametermethode bereitgestellt wird, muss der Benutzer den Typ des Artefakts über den Parameter "-Type" bereitstellen.
Beispiele
Beispiel 1
$bp = Get-AzBlueprint -Name SimpleBlueprint
New-AzBlueprintArtifact -Name PolicyStorage -Blueprint $bp -ArtifactFile C:\PolicyAssignmentStorageTag.json
DisplayName :
Description : Apply storage tag and the parameter also used by the template to resource groups
DependsOn :
PolicyDefinitionId : /providers/Microsoft.Authorization/policyDefinitions/49c88fc8-6fd1-46fd-a676-f12d1d3a4c71
Parameters : {[tagName, Microsoft.Azure.Commands.Blueprint.Models.PSParameterValue], [tagValue, Microsoft.Azure.Commands.Blueprint.Models.PSParameterValue]}
ResourceGroup :
Id : /subscriptions/{subscriptionId}/providers/Microsoft.Blueprint/blueprints/AppNetwork/artifacts/PolicyAssignmentStorageTag
Type : Microsoft.Blueprint/blueprints/artifacts
Name : PolicyAssignmentStorageTag
Erstellen Sie ein neues Artefakt über eine Artefakt-JSON-Datei.
Beispiel 2
$bp = Get-AzBlueprint -Name SimpleBlueprint
New-AzBlueprintArtifact -Type PolicyAssignmentArtifact -Name "ApplyTag-RG" -Blueprint $bp -PolicyDefinitionId "/providers/Microsoft.Authorization/policyDefinitions/49c88fc8-6fd1-46fd-a676-f12d1d3a4c71" -PolicyDefinitionParameter @{tagName="[parameters('tagName')]"; tagValue="[parameters('tagValue')]"} -ResourceGroupName storageRG
DisplayName : ApplyTag-RG
Description :
DependsOn :
PolicyDefinitionId : /providers/Microsoft.Authorization/policyDefinitions/49c88fc8-6fd1-46fd-a676-f12d1d3a4c71
Parameters : {[tagValue, Microsoft.Azure.Commands.Blueprint.Models.PSParameterValue], [tagName,
Microsoft.Azure.Commands.Blueprint.Models.PSParameterValue]}
ResourceGroup : storageRG
Id : /subscriptions/28cbf98f-381d-4425-9ac4-cf342dab9753/providers/Microsoft.Blueprint/blueprints/AppNetwork/
artifacts/ApplyTag-RG
Type : Microsoft.Blueprint/blueprints/artifacts
Name : ApplyTag-RG
Erstellen Sie ein neues Artefakt über Inlineparameter.
Beispiel 3
$bp = Get-AzBlueprint -Name SimpleBlueprint
New-AzBlueprintArtifact -Type TemplateArtifact -Name storage-account -Blueprint $bp -TemplateFile C:\StorageAccountArmTemplate.json -ResourceGroupName "storageRG" -TemplateParameterFile C:\Workspace\BlueprintTemplates\RestTemplatesSomeInline\StorageAccountParameters.json
DisplayName : storage-account
Description :
DependsOn :
Template : {$schema, contentVersion, parameters, variables...}
Parameters : {}
ResourceGroup : storageRG
Id : /subscriptions/{subscriptionId}/providers/Microsoft.Blueprint/blueprints/AppNetwork/artifacts/storage-account
Type : Microsoft.Blueprint/blueprints/artifacts
Name : storage-account
Erstellen Sie ein neues Artefakt über eine ARM-Vorlagendatei.
Parameter
-ArtifactFile
Speicherort der Artefaktdatei im JSON-Format auf dem Datenträger.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Blueprint
Blueprint-Objekt.
Type: | PSBlueprintBase |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DependsOn
Liste der Namen von Artefakten, die erstellt werden müssen, bevor das aktuelle Artefakt erstellt wird.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Description
Beschreibung des Artefakts.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Name des Artefakts
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PolicyDefinitionId
Definitions-ID der Richtliniendefinition.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PolicyDefinitionParameter
Hashtabelle von Parametern, die an das Richtliniendefinitionsartefakt übergeben werden sollen.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
Name der Ressourcengruppe, unter der das Artefakt stehen soll.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RoleDefinitionId
Liste der Rollendefinition
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RoleDefinitionPrincipalId
Liste der Rollendefinitionsprinzipal-IDs.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateFile
Speicherort der ARM-Vorlagendatei auf dem Datenträger.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterFile
Speicherort der ARM-Vorlagenparameterdatei auf dem Datenträger.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Type
Art des Artefakts. Es werden drei Typen unterstützt: RoleAssignmentArtifact, PolicyAssignmentArtifact, TemplateArtifact.
Type: | PSArtifactKind |
Accepted values: | RoleAssignmentArtifact, PolicyAssignmentArtifact, TemplateArtifact |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
String[]
Ausgaben
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für