Den här cmdleten New-AzPolicyEnrollment skapar en principregistrering med angivet omfång och namn.
Policyregistreringar gäller för alla resurser inom deras omfattning.
Till exempel, när du skapar en policyregistrering på resursgruppens omfattning för en policytilldelning på samma eller högre nivå, gäller registreringen för alla tillämpliga resurser i resursgruppen.
Exempel
Exempel 1: Principregistrering i prenumerationsomfång
Det första kommandot hämtar en prenumeration med namnet Subscription01 med hjälp av cmdleten Get-AzSubscription och lagrar den i variabeln $Subscription.
Det andra kommandot hämtar principtilldelningen med namnet VirtualMachinePolicyAssignment med hjälp av cmdleten Get-AzPolicyAssignment och lagrar den i variabeln $Assignment.
Tilldelningen måste ha EnforcementMode inställt på Registrera.
Det sista kommandot skapar principregistreringen för tilldelningen i $Assignment på den prenumerationsnivå som identifieras av prenumerationsomfångssträngen.
Exempel 2: Principregistrering vid hanteringsgruppsomfång
$ManagementGroup = Get-AzManagementGroup -GroupName 'AManagementGroup'
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment'
New-AzPolicyEnrollment -Name 'VirtualMachinePolicyEnrollment' -PolicyAssignmentId $Assignment.Id -Scope $ManagementGroup.Id -Description 'Enrollment for VM policy at MG level'
Det första kommandot hämtar en hanteringsgrupp med namnet AManagementGroup med hjälp av cmdleten Get-AzManagementGroup och lagrar den i variabeln $ManagementGroup.
Det andra kommandot hämtar principtilldelningen med namnet VirtualMachinePolicyAssignment med hjälp av cmdleten Get-AzPolicyAssignment och lagrar den i variabeln $Assignment.
Tilldelningen måste ha EnforcementMode inställt på Registrera.
Det sista kommandot skapar principregistreringen för tilldelningen i $Assignment i hanteringsgruppens omfång som identifieras av ID-egenskapen för $ManagementGroup.
Det första kommandot hämtar den prenumeration som registreringen ska skapas på, den som används för närvarande.
Det andra kommandot hämtar principtilldelningen med namnet VirtualMachinePolicyAssignment med hjälp av cmdleten Get-AzPolicyAssignment och lagrar den i variabeln $Assignment.
Det tredje kommandot skapar ett resursväljareobjekt som begränsar registreringen till resurser i USA, östra eller USA, östra 2 och lagrar det i variabeln $ResourceSelector.
Det sista kommandot skapar principregistreringen för tilldelningen i $Assignment med resursväljaren som anges av $ResourceSelector.
Parametrar
-AssignmentScopeValidation
Alternativet om man ska validera registreringen ligger på eller inom tilldelningsområdet.
När den associerade principtilldelningen är för en principuppsättning (initiativ) kan detta användas för att ange principdefinitionens referens-ID:er för principdefinitioner i den principuppsättning som ska registreras till.
Dessa ID:n motsvarar en delmängd av policyDefinitions[*].policyDefinitionReferenceId i policymängdens definition.
När den anges och inte är tom, kommer endast de refererade policydefinitionerna att registreras.
Annars registreras hela principuppsättningen till.
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.
Källan för det här innehållet finns på GitHub, där du även kan skapa och granska ärenden och pull-begäranden. Se vår deltagarguide för mer information.