Remove-AzPolicyRemediation
Supprime une correction de stratégie.
Syntaxe
DeleteBySubscriptionId (Par défaut)
Remove-AzPolicyRemediation
-Name <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-AllowStop]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DeleteByResourceGroup
Remove-AzPolicyRemediation
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-AllowStop]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DeleteByResourceId
Remove-AzPolicyRemediation
-ResourceId <String>
[-Name <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-AllowStop]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DeleteByScope
Remove-AzPolicyRemediation
-Name <String>
-Scope <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-AllowStop]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DeleteByManagementGroup
Remove-AzPolicyRemediation
-Name <String>
-ManagementGroupId <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-AllowStop]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DeleteViaIdentity
Remove-AzPolicyRemediation
-InputObject <IPolicyInsightsIdentity>
[-DefaultProfile <PSObject>]
[-AsJob]
[-AllowStop]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Remove-AzPolicyRemediation supprime une correction de stratégie.
La correction doit être dans un état de terminal pour être supprimée.
Toutefois, cette applet de commande a un commutateur qui lui permet de forcer l’arrêt d’une correction si elle est toujours en cours, puis va continuer à la supprimer.
Exemples
Exemple 1 : Supprimer une correction de stratégie dans l’étendue du groupe de ressources
Remove-AzPolicyRemediation -ResourceGroupName "myRG" -Name "remediation1"
Cette commande supprime la correction nommée « correction1 » dans le groupe de ressources « myRG ».
Exemple 2 : Supprimer une correction de groupe d’administration via la canalisation
$remediation = Get-AzPolicyRemediation -ManagementGroupId "mg1" -Name "remediation1"
$remediation | Remove-AzPolicyRemediation -Confirm
Cette commande supprime la correction nommée « correction1 » du groupe d’administration « mg1 ».
Une invite de confirmation sera présentée avant de supprimer la ressource.
Exemple 3 : Annuler et supprimer une correction de stratégie
Remove-AzPolicyRemediation -ResourceGroupName "myRG" -Name "remediation1" -AllowStop
Cette commande supprime la correction nommée « correction1 » dans le groupe de ressources « myRG ».
Si la correction est en cours, elle est annulée avant d’être supprimée.
Paramètres
-AllowStop
Autorisez l’annulation de la correction si elle est en cours.
Inoffensif si la correction est déjà dans un état terminal.
Sans ce commutateur, l’applet de commande génère une erreur si la correction n’est pas dans un état terminal.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-AsJob
Exécutez l’applet de commande en arrière-plan.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: Cf
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DefaultProfile
Le paramètre DefaultProfile n’est pas fonctionnel.
Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.
Propriétés du paramètre
Type: PSObject
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: AzureRMContext, AzureCredential
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
Paramètre d’identité
DeleteViaIdentity
Position: Named Obligatoire: True Valeur du pipeline: True Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ManagementGroupId
ID du groupe d’administration.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: NomDuGroupeDeGestion
Jeux de paramètres
DeleteByManagementGroup
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Name
Nom de la correction.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: RemediationName
Jeux de paramètres
DeleteBySubscriptionId
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
DeleteByResourceGroup
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
DeleteByScope
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
DeleteByManagementGroup
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-PassThru
Retourne true lorsque la commande réussit
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ResourceGroupName
Nom du groupe de ressources.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
DeleteByResourceGroup
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ResourceId
ID de la ressource que la correction a été effectuée pour ou ID de ressource complet de la correction.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
DeleteByResourceId
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Scope
Étendue de la ressource.
Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{rgName} ».
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
DeleteByScope
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-SubscriptionId
ID de l’abonnement cible.
Utilise l’abonnement actuel si aucun abonnement n’est fourni.
Propriétés du paramètre
Type: String
Valeur par défaut: (Get-AzContext).Subscription.Id Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
DeleteBySubscriptionId
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
DeleteByResourceGroup
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute.
L’applet de commande ne s’exécute pas.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: Wi
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters .
Sorties
