Megosztás a következőn keresztül:

Set-AzureRmPolicyAssignment

  • Referencia
Modul:
AzureRM.Resources

Módosítja a szabályzat-hozzárendelést.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

Syntax

Set-AzureRmPolicyAssignment
   -Name <String>
   -Scope <String>
   [-NotScope <String[]>]
   [-DisplayName <String>]
   [-Description <String>]
   [-Metadata <String>]
   [-Sku <Hashtable>]
   [-AssignIdentity]
   [-Location <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureRmPolicyAssignment
   [-NotScope <String[]>]
   -Id <String>
   [-DisplayName <String>]
   [-Description <String>]
   [-Metadata <String>]
   [-Sku <Hashtable>]
   [-AssignIdentity]
   [-Location <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

A Set-AzureRmPolicyAssignment parancsmag módosítja a szabályzat-hozzárendelést. Adjon meg egy hozzárendelést azonosító vagy név és hatókör szerint.

Példák

1. példa: A megjelenítendő név frissítése

PS C:\> $ResourceGroup = Get-AzureRmResourceGroup -Name 'ResourceGroup11'
PS C:\> $PolicyAssignment = Get-AzureRmPolicyAssignment -Name 'PolicyAssignment' -Scope $ResourceGroup.ResourceId
PS C:\> Set-AzureRmPolicyAssignment -Id $PolicyAssignment.ResourceId -DisplayName 'Do not allow VM creation'

Az első parancs a Get-AzureRMResourceGroup parancsmaggal lekéri a ResourceGroup11 nevű erőforráscsoportot. A parancs az objektumot a $ResourceGroup változóban tárolja. A második parancs a Get-AzureRmPolicyAssignment parancsmaggal lekéri a PolicyAssignment nevű szabályzat-hozzárendelést. A parancs az objektumot a $PolicyAssignment változóban tárolja. Az utolsó parancs frissíti a házirend-hozzárendelés megjelenített nevét a $ResourceGroup ResourceId tulajdonsága által azonosított erőforráscsoporton.

2. példa: Felügyelt identitás hozzáadása a szabályzat-hozzárendeléshez

PS C:\> $PolicyAssignment = Get-AzureRmPolicyAssignment -Name 'PolicyAssignment'
PS C:\> Set-AzureRmPolicyAssignment -Id $PolicyAssignment.ResourceId -AssignIdentity -Location 'westus'

Az első parancs a Get-AzureRmPolicyAssignment parancsmaggal lekéri a PolicyAssignment nevű szabályzat-hozzárendelést az aktuális előfizetésből. A parancs az objektumot a $PolicyAssignment változóban tárolja. Az utolsó parancs hozzárendel egy felügyelt identitást a szabályzat-hozzárendeléshez.

Paraméterek

-ApiVersion

A használni kívánt erőforrás-szolgáltatói API verzióját adja meg. Ha nem ad meg verziót, ez a parancsmag a legújabb elérhető verziót használja.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-AssignIdentity

Microsoft Entra-identitás létrehozása és hozzárendelése ehhez a szabályzat-hozzárendeléshez. Az identitás a "deployIfNotExists" szabályzatok üzembe helyezésének végrehajtásakor lesz használva. Identitás hozzárendeléséhez hely szükséges.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés

Típus:IAzureContextContainer
Aliasok:AzureRmContext, AzureCredential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Description

A szabályzat-hozzárendelés leírása

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-DisplayName

A szabályzat-hozzárendelés új megjelenítendő nevét adja meg.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Id

Megadja a parancsmag által módosított szabályzat-hozzárendelés teljes erőforrás-azonosítóját.

Típus:String
Aliasok:ResourceId
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-InformationAction

Meghatározza, hogy ez a parancsmag hogyan reagál egy információs eseményre. A paraméter elfogadható értékei a következők:

  • Folytatás
  • Mellőzés
  • Érdeklődni
  • SilentlyContinue
  • Leállítás
  • Felfüggesztés
Típus:ActionPreference
Aliasok:infa
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-InformationVariable

Egy információs változót ad meg.

Típus:String
Aliasok:iv
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Location

A szabályzat-hozzárendelés erőforrás-identitásának helye. Erre a -AssignIdentity kapcsoló használatakor van szükség.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Metadata

A szabályzat-hozzárendelés frissített metaadatai. Ez lehet a metaadatokat tartalmazó fájlnév elérési útja, vagy a metaadatok sztringként.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Name

Megadja annak a szabályzat-hozzárendelésnek a nevét, amelyet ez a parancsmag módosít.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-NotScope

A szabályzat-hozzárendelés nem hatókörök.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Pre

Azt jelzi, hogy ez a parancsmag a kiadás előtti API-verziókat veszi figyelembe, amikor automatikusan meghatározza a használni kívánt verziót.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Scope

Megadja a szabályzat alkalmazási hatókörét.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Sku

Kivonattábla, amely a termékváltozat tulajdonságait jelöli.

Típus:Hashtable
Aliasok:SkuObject
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False