New-AzPolicyEnrollment

New-AzPolicyEnrollment
    -Name <String>
    -Scope <String>
    [-AssignmentScopeValidation <String>]
    [-Description <String>]
    [-DisplayName <String>]
    [-Metadata <String>]
    [-PolicyAssignmentId <String>]
    [-PolicyDefinitionReferenceId <String[]>]
    [-ResourceSelector <IResourceSelector[]>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

這個 New-AzPolicyEnrollment 指令檔會建立一個具有指定範圍與名稱的政策註冊。 政策註冊適用於其範圍內的所有資源。 例如，當你在資源群組範圍內建立政策註冊，針對相同或更高層級的政策指派時，該登錄會適用於該資源群組中所有適用的資源。

$Subscription = Get-AzSubscription -SubscriptionName 'Subscription01'
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment'
New-AzPolicyEnrollment -Name 'VirtualMachinePolicyEnrollment' -PolicyAssignmentId $Assignment.Id -Scope "/subscriptions/$($Subscription.Id)" -DisplayName 'VM Policy Enrollment'

第一個命令會使用 Get-AzSubscription Cmdlet 取得名為 Subscription01 的訂用帳戶，並將它儲存在 $Subscription 變數中。 第二個命令會使用 Get-AzPolicyAssignment Cmdlet 取得名為 VirtualMachinePolicyAssignment 的原則指派，並將它儲存在 $Assignment 變數中。 該指派必須將 EnforcementMode 設定為 Enroll。 最後一個指令會在訂閱範圍字串所識別的訂閱層級建立$Assignment指派的政策註冊。

$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'

第一個命令會使用 Get-AzManagementGroup Cmdlet 取得名為 AManagementGroup 的管理群組，並將它儲存在 $ManagementGroup 變數中。 第二個命令會使用 Get-AzPolicyAssignment Cmdlet 取得名為 VirtualMachinePolicyAssignment 的原則指派，並將它儲存在 $Assignment 變數中。 該指派必須將 EnforcementMode 設定為 Enroll。 最後一個指令會在 $ManagementGroup 的 Id 屬性所識別的管理群組範圍內，建立該指派的政策註冊$Assignment。

$subscription = (Get-AzContext).Subscription
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment'
$ResourceSelector = @{Name = "MyLocationSelector"; Selector = @(@{Kind = "resourceLocation"; In = @("eastus", "eastus2")})}
New-AzPolicyEnrollment -Name 'VirtualMachinePolicyEnrollment' -Scope "/subscriptions/$($subscription.Id)" -PolicyAssignmentId $Assignment.Id -ResourceSelector $ResourceSelector

第一個指令會取得註冊建立的訂閱，也就是目前使用的訂閱。 第二個命令會使用 Get-AzPolicyAssignment Cmdlet 取得名為 VirtualMachinePolicyAssignment 的原則指派，並將它儲存在 $Assignment 變數中。 第三個指令建立一個資源選擇物件，將登錄限制在位於美國東部或美國東部 2 的資源，並將資料儲存在 $ResourceSelector 變數中。 最後一個指令會根據$ResourceSelector指定的資源選擇器，建立指派的政策註冊$Assignment。

此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。