Set-AzureRmPolicyAssignment
Modyfikuje przypisanie zasad.
Ostrzeżenie
Moduł AzureRM PowerShell został oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.
Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.
Składnia
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>] Opis
Polecenie cmdlet Set-AzureRmPolicyAssignment modyfikuje przypisanie zasad. Określ przypisanie według identyfikatora lub nazwy i zakresu.
Przykłady
Przykład 1. Aktualizowanie nazwy wyświetlanej
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'Pierwsze polecenie pobiera grupę zasobów o nazwie ResourceGroup11 przy użyciu polecenia cmdlet Get-AzureRMResourceGroup. Polecenie przechowuje ten obiekt w zmiennej $ResourceGroup. Drugie polecenie pobiera przypisanie zasad o nazwie PolicyAssignment przy użyciu polecenia cmdlet Get-AzureRmPolicyAssignment. Polecenie przechowuje ten obiekt w zmiennej $PolicyAssignment. Końcowe polecenie aktualizuje nazwę wyświetlaną przypisania zasad w grupie zasobów zidentyfikowanej przez właściwość ResourceId $ResourceGroup.
Przykład 2. Dodawanie tożsamości zarządzanej do przypisania zasad
PS C:\> $PolicyAssignment = Get-AzureRmPolicyAssignment -Name 'PolicyAssignment'
PS C:\> Set-AzureRmPolicyAssignment -Id $PolicyAssignment.ResourceId -AssignIdentity -Location 'westus'Pierwsze polecenie pobiera przypisanie zasad o nazwie PolicyAssignment z bieżącej subskrypcji przy użyciu polecenia cmdlet Get-AzureRmPolicyAssignment. Polecenie przechowuje ten obiekt w zmiennej $PolicyAssignment. Ostatnie polecenie przypisuje tożsamość zarządzaną do przypisania zasad.
Parametry
-ApiVersion
Określa wersję interfejsu API dostawcy zasobów do użycia. Jeśli nie określisz wersji, to polecenie cmdlet używa najnowszej dostępnej wersji.
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AssignIdentity
Wygeneruj i przypisz tożsamość entra firmy Microsoft dla tego przypisania zasad. Tożsamość będzie używana podczas wykonywania wdrożeń dla zasad "deployIfNotExists". Lokalizacja jest wymagana podczas przypisywania tożsamości.
| Typ: | SwitchParameter |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure
| Typ: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Opis przypisania zasad
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DisplayName
Określa nową nazwę wyświetlaną przypisania zasad.
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Id
Określa w pełni kwalifikowany identyfikator zasobu dla przypisania zasad, który modyfikuje to polecenie cmdlet.
| Typ: | String |
| Aliases: | ResourceId |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InformationAction
Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne. Dopuszczalne wartości tego parametru to:
- Kontynuuj
- Ignoruj
- Zapytać
- Silentlycontinue
- Zatrzymaj
- Wstrzymanie
| Typ: | ActionPreference |
| Aliases: | infa |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationVariable
Określa zmienną informacyjną.
| Typ: | String |
| Aliases: | iv |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
Lokalizacja tożsamości zasobu przypisania zasad. Jest to wymagane, gdy jest używany przełącznik -AssignIdentity.
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Metadata
Zaktualizowane metadane przypisania zasad. Może to być ścieżka do nazwy pliku zawierającej metadane lub metadanych jako ciąg.
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Określa nazwę przypisania zasad, które modyfikuje to polecenie cmdlet.
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NotScope
Przypisanie zasad nie obejmuje zakresów.
| Typ: | String[] |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Pre
Wskazuje, że to polecenie cmdlet uwzględnia wersje interfejsu API wersji wstępnej, gdy automatycznie określa wersję do użycia.
| Typ: | SwitchParameter |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Scope
Określa zakres, w którym są stosowane zasady.
| Typ: | String |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Sku
Tabela skrótów reprezentująca właściwości jednostki SKU.
| Typ: | Hashtable |
| Aliases: | SkuObject |
| Position: | Named |
| wartość domyślna: | None |
| Wymagane: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |