Partager via


New-AzBlueprintAssignment

Affectez une définition de blueprint à un abonnement ou à un groupe d’administration.

Syntaxe

New-AzBlueprintAssignment
   -Name <String>
   -Blueprint <PSBlueprintBase>
   -Location <String>
   [-SystemAssignedIdentity]
   [-UserAssignedIdentity <String>]
   [-Lock <PSLockMode>]
   [-SecureStringParameter <Hashtable>]
   [-ResourceGroupParameter <Hashtable>]
   [-Parameter <Hashtable>]
   [-ManagementGroupId <String>]
   [-SubscriptionId <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzBlueprintAssignment
   -Name <String>
   [-Blueprint <PSBlueprintBase>]
   [-AssignmentFile <String>]
   [-ManagementGroupId <String>]
   [-SubscriptionId <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Affectez une définition de blueprint à un abonnement.

Exemples

Exemple 1

$rg = @{ResourceGroup=@{name='storage_rg';location='eastus'}}
$params = @{applytaganditsdefaultvalue_tagName="Department_Cost_Center"; applytaganditsdefaultvalue_tagValue="Contoso/RnD/Dev/986754"}
$blueprintObject =  Get-AzBlueprint -SubscriptionId "00000000-1111-0000-1111-000000000000" -Name "myBlueprintName"
$secureString = @{mySecureStringParam=@{keyVaultId='/subscriptions/00000000-1111-0000-1111-000000000000/rsourcegroups/myResourceGroup/providers/Microsoft.Keyvault/Vaults/myKeyVault';secretName='mySecret';secretVersion='1.0'}}
New-AzBlueprintAssignment -Name "myAssignment" -Blueprint $blueprintObject -SubscriptionId "00000000-1111-0000-1111-000000000000" -Location "West US" -ResourceGroupParameter $rg -Parameter $params -SecureStringParameter $secureString

Name              : myAssignment
Id                : /subscriptions/00000000-1111-0000-1111-000000000000/providers/Microsoft.Blueprint/blueprintAssignments/myAssignment
Scope             : /subscriptions/00000000-1111-0000-1111-000000000000
LastModified      : 2019-01-08
LockMode          : None
ProvisioningState : Creating
Parameters        : {applytaganditsdefaultvalue_tagName, applytaganditsdefaultvalue_tagValue}
ResourceGroups    : ResourceGroup

Créez une attribution de blueprint de la définition de blueprint $blueprintObject dans l’abonnement spécifié à l’aide du dictionnaire de paramètres et de groupe de ressources défini. Utilise l’identité affectée par le système. L’emplacement définit la région pour la création de l’identité managée.

Exemple 2

New-AzBlueprintAssignment -Name "myAssignment" -Blueprint $blueprintObject -SubscriptionId 00000000-1111-0000-1111-000000000000 -Location "West US" -Parameter @{P1="v1"; P2="v2"} -Lock AllResourcesReadOnly

Créez une attribution de blueprint de la définition de blueprint $blueprintObject dans l’abonnement spécifié à l’aide du dictionnaire de paramètres et du groupe de ressources définis et de la configuration du verrouillage des ressources pour AllResources. Utilise par défaut l’identité affectée par le système. L’emplacement définit la région pour la création de l’identité managée.

Exemple 3

New-AzBlueprintAssignment -Name "myAssignment" -Blueprint $blueprintObject -SubscriptionId 00000000-1111-0000-1111-000000000000 -Location "West US" -Parameter @{P1="v1"; P2="v2"} -UserAssignedIdentity "/subscriptions/00000000-1111-0000-1111-000000000000/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-user-defined-identity"

Créez une attribution de blueprint de la définition de blueprint $blueprintObject dans l’abonnement spécifié à l’aide du dictionnaire de paramètres et de groupe de ressources défini à l’aide de l’ID d’identité affecté par l’utilisateur spécifié.

Exemple 4

$blueprintObject =  Get-AzBlueprint -SubscriptionId "00000000-1111-0000-1111-000000000000" -Name "myBlueprintName"
New-AzBlueprintAssignment -Name "myAssignment" -Blueprint $blueprintObject -SubscriptionId "00000000-1111-0000-1111-000000000000" -AssignmentFile C:\myAssignmentfile.json

Name              : myAssignment
Id                : /subscriptions/00000000-1111-0000-1111-000000000000/providers/Microsoft.Blueprint/blueprintAssignments/myAssignment
Scope             : /subscriptions/00000000-1111-0000-1111-000000000000
LastModified      : 2019-01-08
LockMode          : None
ProvisioningState : Creating
Parameters        : {applytaganditsdefaultvalue_tagName, applytaganditsdefaultvalue_tagValue}
ResourceGroups    : ResourceGroup

Créez une affectation de blueprint par le biais d’un fichier d’affectation. Le format du fichier d’affectation se trouve dans les exemples de requête/réponse à l’adresse suivante : https://github.com/Azure/azure-rest-api-specs/tree/master/specification/blueprint/resource-manager/Microsoft.Blueprint/preview/2018-11-01-preview/examples

Exemple 5

$blueprintObject =  Get-AzBlueprint -SubscriptionId "myManagementGroup" -Name "myBlueprintName"
New-AzBlueprintAssignment -Name "myAssignment" -Blueprint $blueprintObject -ManagementGroupId "myManagementGroup" -SubscriptionId 00000000-1111-0000-1111-000000000000 -Location "West US" -Parameter @{P1="v1"; P2="v2"}

Créez une attribution de blueprint de la définition de blueprint $blueprintObject ciblant l’abonnement spécifié dans le groupe d’administration spécifié à l’aide du paramètre défini.

Paramètres

-AssignmentFile

Emplacement du fichier d’affectation au format JSON sur le disque.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Blueprint

Objet de définition de blueprint.

Type:PSBlueprintBase
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Location

Région dans laquelle l’identité managée doit être créée. En savoir plus sur aka.ms/blueprintmsi

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Lock

Verrouiller les ressources. En savoir plus sur aka.ms/blueprintlocks

Type:Nullable<T>[PSLockMode]
Valeurs acceptées:None, AllResourcesReadOnly, AllResourcesDoNotDelete
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ManagementGroupId

ID du groupe d’administration où les affectations de blueprint seront enregistrées.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Nom de l’affectation de blueprint.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Parameter

Paramètres d’artefact.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroupParameter

Table de hachage des paramètres à passer à l’artefact du groupe de ressources.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SecureStringParameter

Paramètre de chaîne sécurisée pour l’ID de ressource KeyVault, le nom et la version.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SubscriptionId

ID d’abonnement pour affecter la définition de blueprint. Il peut s’agir d’une liste délimitée par des virgules de chaînes subscriptionId.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SystemAssignedIdentity

Identité affectée par le système (MSI) pour déployer les artefacts.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserAssignedIdentity

Identité affectée par l’utilisateur (MSI) pour déployer les artefacts.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

PSBlueprintBase

String[]

Hashtable

Sorties

Object