Rutina New-AzPolicyAssignment vytvoří nebo aktualizuje přiřazení zásad s daným oborem a názvem.
Přiřazení zásad se vztahují na všechny prostředky obsažené v jejich oboru.
Když například přiřadíte zásadu v oboru skupiny prostředků, tato zásada se vztahuje na všechny prostředky ve skupině.
První příkaz získá předplatné s názvem Subscription01 pomocí rutiny Get-AzSubscription a uloží ho do proměnné $Subscription.
Druhý příkaz získá definici zásady s názvem VirtualMachinePolicy pomocí rutiny Get-AzPolicyDefinition a uloží ji do proměnné $Policy.
Poslední příkaz přiřadí zásadu v $Policy na úrovni předplatného identifikované řetězcem oboru předplatného.
Příklad 2: Přiřazení zásad na úrovni skupiny prostředků
První příkaz získá skupinu prostředků s názvem ResourceGroup11 pomocí rutiny Get-AzResourceGroup a uloží ji do proměnné $ResourceGroup.
Druhý příkaz získá definici zásady s názvem VirtualMachinePolicy pomocí rutiny Get-AzPolicyDefinition a uloží ji do proměnné $Policy.
Poslední příkaz přiřadí zásadu v $Policy na úrovni skupiny prostředků identifikované vlastností ResourceId $ResourceGroup.
Příklad 3: Přiřazení zásad na úrovni skupiny prostředků s objektem parametru zásad
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á integrovanou definici zásad pro povolená umístění pomocí rutiny Get-AzPolicyDefinition.
Příkaz uloží tento objekt do proměnné $Policy.
Třetí a čtvrtý příkaz vytvoří objekt obsahující všechny Azure oblasti s názvem east.
Příkazy ukládají tento objekt do proměnné $AllowedLocations.
Poslední příkaz přiřadí zásadu v $Policy na úrovni skupiny prostředků pomocí objektu parametru zásad v $AllowedLocations.
Vlastnost ResourceId $ResourceGroup identifikuje skupinu prostředků.
Příklad 4: Přiřazení zásad na úrovni skupiny prostředků pomocí souboru parametrů zásad
První příkaz vytvoří soubor parametrů s názvem AllowedLocations.json v místním pracovním adresáři.
Druhý příkaz získá skupinu prostředků s názvem ResourceGroup11 pomocí rutiny Get-AzResourceGroup a uloží ji do proměnné $ResourceGroup.
Třetí příkaz získá integrovanou definici zásad pro povolená umístění pomocí rutiny Get-AzPolicyDefinition a uloží ji do proměnné $Policy.
Poslední příkaz přiřadí zásadu v $Policy ve skupině prostředků identifikované vlastností ResourceId $ResourceGroup pomocí souboru parametrů zásad AllowedLocations.json z místního pracovního adresáře.
Příklad 5: Přiřazení zásad se spravovanou identitou přiřazenou systémem
První příkaz získá skupinu prostředků s názvem ResourceGroup11 pomocí rutiny Get-AzResourceGroup a uloží ji do proměnné $ResourceGroup.
Druhý příkaz získá definici zásady s názvem VirtualMachinePolicy pomocí rutiny Get-AzPolicyDefinition a uloží ji do proměnné $Policy.
Poslední příkaz přiřadí zásadu ve $Policy ke skupině prostředků.
Spravovaná identita přiřazená systémem se automaticky vytvoří a přiřadí k přiřazení zásady.
Příklad 6: Přiřazení zásad se spravovanou identitou přiřazenou uživatelem
První příkaz získá skupinu prostředků s názvem ResourceGroup11 pomocí rutiny Get-AzResourceGroup a uloží ji do proměnné $ResourceGroup.
Druhý příkaz získá definici zásady s názvem VirtualMachinePolicy pomocí rutiny Get-AzPolicyDefinition a uloží ji do proměnné $Policy.
Třetí příkaz získá spravovanou identitu přiřazenou uživatelem s názvem UserAssignedIdentity1 pomocí rutiny Get-AzUserAssignedIdentity a uloží ji do proměnné $UserAssignedIdentity.
Poslední příkaz přiřadí zásadu ve $Policy ke skupině prostředků.
Spravovaná identita přiřazená uživatelem identifikovaná vlastností ID $UserAssignedIdentity je přiřazena k přiřazení zásady předáním vlastnosti ID* parametru IdentityId.
Příklad 7: Přiřazení zásad s vlastností režimu vynucení
První příkaz získá předplatné s názvem Subscription01 pomocí rutiny Get-AzSubscription a uloží ho do proměnné $Subscription.
Druhý příkaz získá definici zásady s názvem VirtualMachinePolicy pomocí rutiny Get-AzPolicyDefinition a uloží ji do proměnné $Policy.
Poslední příkaz přiřadí zásadu v $Policy na úrovni předplatného identifikované řetězcem oboru předplatného.
Přiřazení je nastaveno s hodnotou EnforcementMode doNotEnforce , tj. efekt zásady se nevynucuje při vytváření nebo aktualizaci prostředku.
Příklad 8: Přiřazení zásad se zprávami o nedodržování předpisů
$PolicySet = Get-AzPolicySetDefinition -Name 'VirtualMachinePolicySet'
$NonComplianceMessages = @(@{Message="Only DsV2 SKUs are allowed."; PolicyDefinitionReferenceId="DefRef1"}, @{Message="Virtual machines must follow cost management best practices."})
New-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment' -PolicySetDefinition $PolicySet -NonComplianceMessage $NonComplianceMessages
První příkaz získá definici sady zásad s názvem VirtualMachinePolicySet pomocí rutiny Get-AzPolicySetDefinition a uloží ji do proměnné $PolicySet.
Druhý příkaz vytvoří pole zpráv, které nedodržují předpisy.
Jedna zpráva pro obecné účely pro celé přiřazení a jednu zprávu specifickou pro zásadu omezení skladové položky v rámci definice přiřazené sady zásad.
Poslední příkaz přiřadí definici sady zásad v $PolicySet k odběru se dvěma zprávami o nedodržování předpisů, které se zobrazí v případě odepření prostředku zásadami.
Příklad 9: Přiřazení zásad pomocí selektoru prostředků
První příkaz získá definici zásady s názvem VirtualMachinePolicy pomocí rutiny Get-AzPolicyDefinition a uloží ji do proměnné $Policy.
Druhý příkaz vytvoří objekt selektoru prostředků, který se použije k určení přiřazení, by se měl vztahovat pouze na prostředky umístěné v oblasti USA – východ nebo USA – východ 2 a uloží ho do proměnné $ResourceSelector.
Poslední příkaz přiřadí definici zásady v $Policy předplatnému pomocí selektoru prostředků určeným $ResourceSelector.
První příkaz získá definici zásady s názvem VirtualMachinePolicy pomocí rutiny Get-AzPolicyDefinition a uloží ji do proměnné $Policy.
Druhý příkaz vytvoří selektor umístění určující umístění USA – východ nebo USA – východ 2 a uloží ho do proměnné $Selector.
Třetí příkaz vytvoří objekt přepsání, který se použije k určení, že přiřazená definice by měla mít v umístěních identifikovaných objektem $Selector a uloží ho do proměnné $Override.
Poslední příkaz přiřadí definici zásady v $Policy předplatnému s přepsáním určeným $Override.
Příklad 11: [Backcompat] Přiřazení zásad na úrovni skupiny prostředků s objektem parametru zásad
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á integrovanou definici zásad pro povolená umístění pomocí rutiny Get-AzPolicyDefinition.
Příkaz uloží tento objekt do proměnné $Policy.
Třetí a čtvrtý příkaz vytvoří objekt obsahující všechny Azure oblasti s názvem east.
Příkazy ukládají tento objekt do proměnné $AllowedLocations.
Poslední příkaz přiřadí zásadu v $Policy na úrovni skupiny prostředků pomocí objektu parametru zásad v $AllowedLocations.
Vlastnost ResourceId $ResourceGroup identifikuje skupinu prostředků.
Příklad 12: [Backcompat] Přiřazení zásad na úrovni skupiny prostředků se souborem parametrů zásad
První příkaz vytvoří soubor parametrů s názvem AllowedLocations.json v místním pracovním adresáři.
Druhý příkaz získá skupinu prostředků s názvem ResourceGroup11 pomocí rutiny Get-AzResourceGroup a uloží ji do proměnné $ResourceGroup.
Třetí příkaz získá integrovanou definici zásad pro povolená umístění pomocí rutiny Get-AzPolicyDefinition a uloží ji do proměnné $Policy.
Poslední příkaz přiřadí zásadu v $Policy ve skupině prostředků identifikované vlastností ResourceId $ResourceGroup pomocí souboru parametrů zásad AllowedLocations.json z místního pracovního adresáře.
Parametry
-BackwardCompatible
Způsobí, že rutina vrátí artefakty pomocí staršího formátu, který umísťuje vlastnosti specifické pro zásady do objektu kontejneru vlastností.
Identita uživatele přidružená k zásadě.
Odkazy na klíč slovníku identit uživatele budou ID prostředků ARM ve formátu: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.
Zprávy, které popisují, proč prostředek nedodržuje zásady.
Chcete-li vytvořit, přečtěte si část NOTES pro vlastnosti NONCOMPLIANCEMESSAGE a vytvořte hashovací tabulku.
Rozsah přiřazení zásady.
Platné obory jsou: skupina pro správu (formát: /providers/Microsoft.Management/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}'
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.