Start-AzPolicyRemediation
İlke ataması için bir ilke düzeltmesi oluşturur ve başlatır.
Sözdizimi
Start-AzPolicyRemediation
-Name <String>
[-Scope <String>]
[-ManagementGroupName <String>]
[-ResourceGroupName <String>]
-PolicyAssignmentId <String>
[-PolicyDefinitionReferenceId <String>]
[-LocationFilter <String[]>]
[-ResourceDiscoveryMode <String>]
[-ResourceCount <Int32>]
[-ParallelDeploymentCount <Int32>]
[-FailureThreshold <Double>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Start-AzPolicyRemediation
-ResourceId <String>
-PolicyAssignmentId <String>
[-PolicyDefinitionReferenceId <String>]
[-LocationFilter <String[]>]
[-ResourceDiscoveryMode <String>]
[-ResourceCount <Int32>]
[-ParallelDeploymentCount <Int32>]
[-FailureThreshold <Double>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Start-AzPolicyRemediation cmdlet'i, belirli bir ilke ataması için bir ilke düzeltmesi oluşturur. Düzeltme kapsamının altındaki veya altındaki tüm uyumlu olmayan kaynaklar düzeltilir. Düzeltme yalnızca 'deployIfNotExists' etkisine sahip ilkeler için desteklenir.
Örnekler
Örnek 1: Abonelik kapsamında düzeltme başlatma
$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1"Bu komut, verilen ilke ataması için 'Aboneliğim' aboneliğinde yeni bir ilke düzeltmesi oluşturur.
Örnek 2: İsteğe bağlı filtrelerle yönetim grubu kapsamında düzeltme başlatma
$policyAssignmentId = "/providers/Microsoft.Management/managementGroups/mg1/providers/Microsoft.Authorization/policyAssignments/pa1"
Start-AzPolicyRemediation -ManagementGroupName "mg1" -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -LocationFilter "westus","eastus"Bu komut, verilen ilke ataması için 'mg1' yönetim grubunda yeni bir ilke düzeltmesi oluşturur. Yalnızca 'westus' veya 'eastus' konumlarındaki kaynaklar düzeltilecektir.
Örnek 3: İlke kümesi tanım ataması için kaynak grubu kapsamında düzeltme başlatma
$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/resourceGroups/myRG/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Start-AzPolicyRemediation -ResourceGroupName "myRG" -PolicyAssignmentId $policyAssignmentId -PolicyDefinitionReferenceId "0349234412441" -Name "remediation1"Bu komut, verilen ilke ataması için 'myRG' kaynak grubunda yeni bir ilke düzeltmesi oluşturur. İlke ataması bir ilke kümesi tanımı atar (girişim olarak da bilinir). İlke tanımı başvuru kimliği, girişim içindeki hangi ilkenin düzeltilmesi gerektiğini belirtir.
Örnek 4: Bir düzeltme başlatın ve arka planda tamamlanmasını bekleyin
$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription f0710c27-9663-4c05-19f8-1b4be01e86a5
$job = Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -AsJob
$job | Wait-Job
$remediation = $job | Receive-JobBu komut, verilen ilke ataması için 'Aboneliğim' aboneliğinde yeni bir ilke düzeltmesi başlatır. Son düzeltme durumunu döndürmeden önce düzeltmenin tamamlanmasını bekler.
Örnek 5: Düzeltmeden önce uyumlu olmayan kaynakları keşfedecek bir düzeltme başlatın
$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -ResourceDiscoveryMode ReEvaluateComplianceBu komut, verilen ilke ataması için 'Aboneliğim' aboneliğinde yeni bir ilke düzeltmesi oluşturur. Abonelikteki kaynakların uyumluluk durumu ilke atamasına göre yeniden değerlendirilir ve uyumlu olmayan kaynaklar düzeltilir.
Örnek 6: En fazla 10.000 uyumsuz kaynağı düzeltecek bir düzeltme başlatın
$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -ResourceCount 10000Örnek 7: 30 kaynağı paralel olarak düzeltecek bir düzeltme başlatın
$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -ParallelDeploymentCount 30Örnek 8: Düzeltme dağıtımlarının yarısından fazlası başarısız olursa sonlandırılacak bir düzeltme başlatın
$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -FailureThreshold 0.5Parametreler
-AsJob
Cmdlet'i arka planda çalıştırın.
| Tür: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
| Tür: | SwitchParameter |
| Diğer adlar: | cf |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
| Tür: | IAzureContextContainer |
| Diğer adlar: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
-FailureThreshold
Hata yüzdesi eşiğini temsil eden 0,0 ile 1,0 arasındaki sayı. Başarısız düzeltme işlemlerinin yüzdesi (başarısız dağıtımlar) bu eşiği aşarsa düzeltme başarısız olur.
| Tür: | Nullable<T>[Double] |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-LocationFilter
Düzeltmeye dahil edilmesi gereken kaynak konumları. Bu konumlarda bulunmayan kaynaklar düzeltilmeyecek.
| Tür: | String[] |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-ManagementGroupName
Yönetim grubu kimliği.
| Tür: | String |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-Name
Kaynak adı.
| Tür: | String |
| Position: | Named |
| Default value: | None |
| Gerekli: | True |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-ParallelDeploymentCount
Herhangi bir zamanda kaç kaynağın düzeltileceğini. Düzeltmenin hızını denetlemek için kullanılabilir. Sağlanmazsa, varsayılan paralel dağıtımlar değeri kullanılır.
| Tür: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-PolicyAssignmentId
İlke atama kimliği. Örneğin, '/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyAssignments/{assignmentName}'.
| Tür: | String |
| Position: | Named |
| Default value: | None |
| Gerekli: | True |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-PolicyDefinitionReferenceId
Düzeltilmekte olan tek tek tanımın ilke tanımı başvuru kimliğini alır. İlke ataması bir ilke kümesi tanımı atadığında gereklidir.
| Tür: | String |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-ResourceCount
Düzeltilecek en fazla uyumlu olmayan kaynak sayısı. Sağlanmadıysa, varsayılan kaynak sayısı kullanılır.
| Tür: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-ResourceDiscoveryMode
Düzeltme görevinin düzeltilmesi gereken kaynakları nasıl keşfedeceğini açıklar. Yönetim grubu kapsamları düzeltilirken ReEvaluateCompliance desteklenmez.
| Tür: | String |
| Kabul edilen değerler: | ExistingNonCompliant, ReEvaluateCompliance |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-ResourceGroupName
Kaynak grubu adı.
| Tür: | String |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-ResourceId
Kaynak Kimliği.
| Tür: | String |
| Diğer adlar: | Id |
| Position: | Named |
| Default value: | None |
| Gerekli: | True |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-Scope
Kaynağın kapsamı. Örneğin, '/subscriptions/{subscriptionId}/resourceGroups/{rgName}'.
| Tür: | String |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
| Tür: | SwitchParameter |
| Diğer adlar: | wi |
| Position: | Named |
| Default value: | None |
| Gerekli: | False |
| İşlem hattı girişini kabul et: | False |
| Joker karakterleri kabul et: | False |
Girişler
String[]
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=7.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Nullable<T>[[System.Double, System.Private.CoreLib, Version=7.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]