New-AzBlueprintAssignment

Den här cmdleten är en del av en förhandsversionsmodul . Förhandsversioner rekommenderas inte för användning i produktionsmiljöer. Mer information finns i https://aka.ms/azps-refstatus.

Tilldela en skissdefinition till en prenumeration eller en hanteringsgrupp.

Syntax

CreateBlueprintAssignment (Standard)

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>]

CreateBlueprintAssignmentByFile

New-AzBlueprintAssignment
    -Name <String>
    [-Blueprint <PSBlueprintBase>]
    [-AssignmentFile <String>]
    [-ManagementGroupId <String>]
    [-SubscriptionId <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Tilldela en skissdefinition till en prenumeration.

Exempel

Exempel 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/resourcegroups/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

Skapa en ny skisstilldelning av skissdefinitionen $blueprintObject i den angivna prenumerationen med hjälp av den definierade parametern och resursgruppsordlistan. Använder systemtilldelad identitet. Platsen definierar regionen för att skapa den hanterade identiteten.

Exempel 2

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

Skapa en ny skisstilldelning av skissdefinitionen $blueprintObject i den angivna prenumerationen med den definierade parametern och resursgruppsordlistan och konfigurera resurslåsning till AllResources. Standardvärdet är att använda systemtilldelad identitet. Platsen definierar regionen för att skapa den hanterade identiteten.

Exempel 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"

Skapa en ny skisstilldelning av skissdefinitionen $blueprintObject i den angivna prenumerationen med hjälp av den definierade parametern och resursgruppsordlistan med det angivna användartilldelade identitets-ID:t.

Exempel 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

Skapa en skisstilldelning via en tilldelningsfil. Formatet för tilldelningsfilen finns i exempel på begäran/svar på: https://github.com/Azure/azure-rest-api-specs/tree/master/specification/blueprint/resource-manager/Microsoft.Blueprint/preview/2018-11-01-preview/examples

Exempel 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"}

Skapa en ny skisstilldelning av skissdefinitionen $blueprintObject för den angivna prenumerationen i den angivna hanteringsgruppen med hjälp av den definierade parametern.

Parametrar

-AssignmentFile

Plats för tilldelningsfilen i JSON-format på disk.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateBlueprintAssignmentByFile
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Blueprint

Skissdefinitionsobjekt.

Parameteregenskaper

Typ:PSBlueprintBase
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateBlueprintAssignment
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Location

Region för hanterad identitet som ska skapas i. Läs mer på aka.ms/blueprintmsi

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateBlueprintAssignment
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Lock

Lås resurser. Läs mer på aka.ms/blueprintlocks

Parameteregenskaper

Typ:

Nullable<T>[PSLockMode]

Standardvärde:None
Godkända värden:None, AllResourcesReadOnly, AllResourcesDoNotDelete
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateBlueprintAssignment
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ManagementGroupId

ID:t för hanteringsgruppen där skisstilldelningarna sparas.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateBlueprintAssignment
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

Namn på skisstilldelning.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateBlueprintAssignment
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Parameter

Artefaktparametrar.

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateBlueprintAssignment
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ResourceGroupParameter

Hashtable med parametrar som ska skickas till resursgruppens artefakt.

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateBlueprintAssignment
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-SecureStringParameter

Säker strängparameter för KeyVault-resurs-ID, namn och version.

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateBlueprintAssignment
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SubscriptionId

Prenumerations-ID för att tilldela skissdefinitionen. Kan vara en kommaavgränsad lista över subscriptionId-strängar.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateBlueprintAssignment
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-SystemAssignedIdentity

Systemtilldelad identitet (MSI) för att distribuera artefakterna.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateBlueprintAssignment
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-UserAssignedIdentity

Användartilldelad identitet (MSI) för att distribuera artefakterna.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CreateBlueprintAssignment
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

PSBlueprintBase

String

Hashtable

Utdata

Object