Update-AzPolicyEnrollment

Modul:

Az.Resources Module

Tato operace aktualizuje registraci zásad s nově poskytnutými vlastnostmi.

Syntax

UpdateByNameAndScope (Výchozí)

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

UpdateByInputObject

Update-AzPolicyEnrollment
    -InputObject <IPolicyEnrollment>
    [-Description <String>]
    [-DisplayName <String>]
    [-AssignmentScopeValidation <String>]
    [-ResourceSelector <IResourceSelector[]>]
    [-PolicyDefinitionReferenceId <String[]>]
    [-Metadata <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

UpdateById

Update-AzPolicyEnrollment
    -Id <String>
    [-Description <String>]
    [-DisplayName <String>]
    [-AssignmentScopeValidation <String>]
    [-ResourceSelector <IResourceSelector[]>]
    [-PolicyDefinitionReferenceId <String[]>]
    [-Metadata <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Description

Rutina Update-AzPolicyEnrollment aktualizuje registraci zásad s nově poskytnutými vlastnostmi.

Všechny vlastnosti, které nejsou poskytnuty, se zachovají z existující registrace.

Příklady

Příklad 1: Aktualizace zobrazovaného názvu

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyEnrollment = Get-AzPolicyEnrollment -Name 'PolicyEnrollment07' -Scope $ResourceGroup.ResourceId
Update-AzPolicyEnrollment -Id $PolicyEnrollment.Id -DisplayName 'Enrollment for VM location policy'

První příkaz získá skupinu prostředků s názvem ResourceGroup11 pomocí rutiny Get-AzResourceGroup. Příkaz uloží tento objekt do proměnné $ResourceGroup. Druhý příkaz získá registraci zásad s názvem PolicyEnrollment07 pomocí rutiny Get-AzPolicyEnrollment. Příkaz uloží tento objekt do proměnné $PolicyEnrollment. Poslední příkaz aktualizuje zobrazovaný název registrace zásad identifikovanou vlastností ID $PolicyEnrollment.

Příklad 2: Aktualizace prostřednictvím kanálu

$PolicyEnrollment = Get-AzPolicyEnrollment -Name 'PolicyEnrollment07' -Scope "/subscriptions/$((Get-AzContext).Subscription.Id)"
$PolicyEnrollment.DisplayName = 'Updated VM Enrollment'
$PolicyEnrollment | Update-AzPolicyEnrollment

První příkaz získá registraci zásad s názvem PolicyEnrollment07 pomocí rutiny Get-AzPolicyEnrollment a uloží ji do proměnné $PolicyEnrollment. Druhý příkaz nastaví nový zobrazovaný název objektu $PolicyEnrollment. Poslední příkaz předá upravený objekt tak, aby Update-AzPolicyEnrollment, aby se změna zachovala.

Příklad 3: Aktualizace selektoru prostředků

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$ResourceSelector = @{Name = "MyLocationSelector"; Selector = @(@{Kind = "resourceLocation"; NotIn = @("eastus", "eastus2")})}
Update-AzPolicyEnrollment -Name 'VirtualMachinePolicyEnrollment' -Scope $ResourceGroup.ResourceId -ResourceSelector $ResourceSelector

První příkaz získá skupinu prostředků s názvem ResourceGroup11 pomocí rutiny Get-AzResourceGroup. Druhý příkaz vytvoří objekt selektoru prostředků, který omezí registraci na prostředky v jiných umístěních než USA – východ nebo USA – východ 2 a uloží ho do proměnné $ResourceSelector. Poslední příkaz aktualizuje registraci zásad s názvem VirtualMachinePolicyEnrollment selektorem prostředků určeným $ResourceSelector.

Parametry

-AssignmentScopeValidation

Možnost, zda registraci ověřit, je v rozsahu zadání nebo v rámci něj.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

Parametr DefaultProfile není funkční. Pokud je k dispozici spuštění rutiny pro jiné předplatné, použijte parametr SubscriptionId.

Vlastnosti parametru

Typ:	PSObject
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzureRMContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Description

Popis zápisu do pojistky.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DisplayName

Zobrazovaný název registrace pojistky.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Id

ID registrace zásad, která se má aktualizovat. Použijte formát {scope}/providers/Microsoft. Autorizace/policyEnrollments/{policyEnrollmentName}'.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	ResourceId

Sady parametrů

UpdateById

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-InputObject

Objekt registrace zásad, který se má aktualizovat.

Vlastnosti parametru

Typ:	IPolicyEnrollment
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

UpdateByInputObject

Position:	Named
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Metadata

Metadata o registraci pojistek. Metadata jsou otevřený objekt, který je obvykle kolekcí párů klíč-hodnota.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Name

Název zápisu do pojistky.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	PolicyEnrollmentName

Sady parametrů

UpdateByNameAndScope

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-PolicyDefinitionReferenceId

Pokud je přidružené přiřazení zásad pro sadu zásad (iniciativu), můžete použít k určení ID definic zásad pro definice zásad v sadě zásad, do které se mají zaregistrovat. Tyto ID odpovídají podmnožině v policyDefinitions[*].policyDefinitionReferenceId definici sady politik. Pokud je specifikováno a není prázdné, budou registrovány pouze odkazované definice politik. V opačném případě se celá sada zásad zaregistruje.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ResourceSelector

Seznam selektoru prostředků pro filtrování zásad podle vlastností prostředků.

Vlastnosti parametru

Typ:	IResourceSelector[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Scope

Rozsah registrace zásad. Platné obory jsou: skupina pro správu (formát: /providers/Microsoft. Správa/managementGroups/{managementGroup}'), předplatné (formát: /subscriptions/{subscriptionId}), skupina prostředků (formát: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}) nebo prostředek (formát: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}')

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

UpdateByNameAndScope

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

IPolicyEnrollment

IResourceSelector

String

String

Výstupy

IPolicyEnrollment