New-AzPolicyEnrollment

Skapar en principregistrering.

Syntax

Default (Standard)

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

Description

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

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

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.

Exempel 3: Principregistrering med resursväljare

$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

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.

Parameteregenskaper

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

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

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Parameteregenskaper

Typ:PSObject
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias: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

-Description

Beskrivningen av försäkringsanmälan.

Parameteregenskaper

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

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

-DisplayName

Visningsnamnet på försäkringsanmälan.

Parameteregenskaper

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

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

-Metadata

Metadata för policyregistrering. Metadata är ett öppet slutobjekt och är vanligtvis en samling nyckelvärdepar.

Parameteregenskaper

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

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

-Name

Namnet på försäkringsanmälan.

Parameteregenskaper

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

Parameteruppsättningar

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

-PolicyAssignmentId

ID:t för policyuppdraget som registreras.

Parameteregenskaper

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

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

-PolicyDefinitionReferenceId

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.

Parameteregenskaper

Typ:

String[]

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

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

-ResourceSelector

Listan över resursväljare för att filtrera principer efter resursegenskaper.

Parameteregenskaper

Typ:

IResourceSelector[]

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

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

-Scope

Omfånget för principregistreringen. Giltiga omfång är: hanteringsgrupp (format: '/providers/Microsoft. Management/managementGroups/{managementGroup}'), prenumeration (format: '/subscriptions/{subscriptionId}'), resursgrupp (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'), eller resurs (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}')

Parameteregenskaper

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

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
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.

Utdata

IPolicyEnrollment