Update-AzActionGroup

Module:
Az.Monitor Module

mettez à jour un nouveau groupe d’actions ou mettez à jour un groupe d’actions existant.

Syntaxe

UpdateExpanded (Par défaut) 

Update-AzActionGroup
    -Name <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-ArmRoleReceiver <IArmRoleReceiver[]>]
    [-AutomationRunbookReceiver <IAutomationRunbookReceiver[]>]
    [-AzureAppPushReceiver <IAzureAppPushReceiver[]>]
    [-AzureFunctionReceiver <IAzureFunctionReceiver[]>]
    [-EmailReceiver <IEmailReceiver[]>]
    [-Enabled]
    [-EventHubReceiver <IEventHubReceiver[]>]
    [-GroupShortName <String>]
    [-ItsmReceiver <IItsmReceiver[]>]
    [-LogicAppReceiver <ILogicAppReceiver[]>]
    [-SmsReceiver <ISmsReceiver[]>]
    [-Tag <Hashtable>]
    [-VoiceReceiver <IVoiceReceiver[]>]
    [-WebhookReceiver <IWebhookReceiver[]>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentityExpanded 

Update-AzActionGroup
    -InputObject <IActionGroupIdentity>
    [-ArmRoleReceiver <IArmRoleReceiver[]>]
    [-AutomationRunbookReceiver <IAutomationRunbookReceiver[]>]
    [-AzureAppPushReceiver <IAzureAppPushReceiver[]>]
    [-AzureFunctionReceiver <IAzureFunctionReceiver[]>]
    [-EmailReceiver <IEmailReceiver[]>]
    [-Enabled]
    [-EventHubReceiver <IEventHubReceiver[]>]
    [-GroupShortName <String>]
    [-ItsmReceiver <IItsmReceiver[]>]
    [-LogicAppReceiver <ILogicAppReceiver[]>]
    [-SmsReceiver <ISmsReceiver[]>]
    [-Tag <Hashtable>]
    [-VoiceReceiver <IVoiceReceiver[]>]
    [-WebhookReceiver <IWebhookReceiver[]>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

mettez à jour un nouveau groupe d’actions ou mettez à jour un groupe d’actions existant.

Exemples

Exemple 1 : Ajouter un récepteur au groupe d’actions spécifié

$enventhub = New-AzActionGroupEventHubReceiverObject -EventHubName "testEventHub" -EventHubNameSpace "actiongrouptest" -Name "sample eventhub" -SubscriptionId '{subid}'
Update-AzActionGroup -Name actiongroup1 -ResourceGroupName monitor-action -EventHubReceiver $enventhub

ArmRoleReceiver           : {}
AutomationRunbookReceiver : {}
AzureAppPushReceiver      : {}
AzureFunctionReceiver     : {}
EmailReceiver             : {{
                              "name": "user1",
                              "emailAddress": "{user}@microsoft.com",
                              "useCommonAlertSchema": false,
                              "status": "Enabled"
                            }}
Enabled                   : False
EventHubReceiver          : {{
                              "name": "sample eventhub",
                              "eventHubNameSpace": "actiongrouptest",
                              "eventHubName": "testEventHub",
                              "useCommonAlertSchema": false,
                              "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
                              "subscriptionId": "{subid}"
                            }}
GroupShortName            : ag1
Id                        : /subscriptions/{subid}/resourceGroups/monitor-action/providers/microsoft.insights/actionGroups/actiongroup1
ItsmReceiver              : {}
Location                  : southcentralus
LogicAppReceiver          : {}
Name                      : actiongroup1
ResourceGroupName         : monitor-action
SmsReceiver               : {{
                              "name": "user2",
                              "countryCode": "{code}",
                              "phoneNumber": "{phonenumber}",
                              "status": "Enabled"
                            }}
Tag                       : {
                            }
Type                      : Microsoft.Insights/ActionGroups
VoiceReceiver             : {}
WebhookReceiver           : {}

Cette commande met à jour le groupe d’actions spécifié avec le nom et le groupe.

Exemple 2 : Supprimer le récepteur dans le groupe d’actions spécifié

$ag = Get-AzActionGroup -Name actiongroup1 -ResourceGroupName monitor-action
Update-AzActionGroup -InputObject $ag -EventHubReceiver $null

ArmRoleReceiver           : {}
AutomationRunbookReceiver : {}
AzureAppPushReceiver      : {}
AzureFunctionReceiver     : {}
EmailReceiver             : {{
                              "name": "user1",
                              "emailAddress": "{user}@microsoft.com",
                              "useCommonAlertSchema": false,
                              "status": "Enabled"
                            }}
Enabled                   : False
EventHubReceiver          : {}
GroupShortName            : ag1
Id                        : /subscriptions/{subid}/resourceGroups/Monitor-Action/providers/microsoft.insights/actionGroups/actiongroup1
ItsmReceiver              : {}
Location                  : southcentralus
LogicAppReceiver          : {}
Name                      : actiongroup1
ResourceGroupName         : Monitor-Action
SmsReceiver               : {{
                              "name": "user2",
                              "countryCode": "{code}",
                              "phoneNumber": "{phonenumber}",
                              "status": "Enabled"
                            }}
Tag                       : {
                            }
Type                      : Microsoft.Insights/ActionGroups
VoiceReceiver             : {}
WebhookReceiver           : {}

La première commande obtient le groupe d’actions spécifié. La commande finale met à jour le groupe d’actions spécifié avec l’objet de groupe d’actions.

Paramètres

-ArmRoleReceiver

Liste des récepteurs de rôles ARM qui font partie de ce groupe d’actions. Les rôles sont des rôles RBAC Azure et seuls les rôles intégrés sont pris en charge.

Propriétés du paramètre

Type:

IArmRoleReceiver[]

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

-AutomationRunbookReceiver

Liste des récepteurs AutomationRunbook qui font partie de ce groupe d’actions.

Propriétés du paramètre

Type:

IAutomationRunbookReceiver[]

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

-AzureAppPushReceiver

Liste des récepteurs AzureAppPush qui font partie de ce groupe d’actions.

Propriétés du paramètre

Type:

IAzureAppPushReceiver[]

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

-AzureFunctionReceiver

Liste des récepteurs de fonction Azure qui font partie de ce groupe d’actions.

Propriétés du paramètre

Type:

IAzureFunctionReceiver[]

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

-EmailReceiver

Liste des récepteurs de courrier qui font partie de ce groupe d’actions.

Propriétés du paramètre

Type:

IEmailReceiver[]

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

-Enabled

Indique si ce groupe d’actions est activé. Si un groupe d’actions n’est pas activé, aucun de ses récepteurs ne reçoit de communications.

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

-EventHubReceiver

Liste des récepteurs Event Hub qui font partie de ce groupe d’actions.

Propriétés du paramètre

Type:

IEventHubReceiver[]

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

-GroupShortName

Nom court du groupe d’actions. Cela sera utilisé dans les sms.

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:ShortName

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

-InputObject

Paramètre d’identité

Propriétés du paramètre

Type:IActionGroupIdentity
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UpdateViaIdentityExpanded
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ItsmReceiver

Liste des récepteurs ITSM qui font partie de ce groupe d’actions.

Propriétés du paramètre

Type:

IItsmReceiver[]

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

-LogicAppReceiver

Liste des récepteurs d’application logique qui font partie de ce groupe d’actions.

Propriétés du paramètre

Type:

ILogicAppReceiver[]

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

-Name

Nom du groupe d’actions.

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:ActionGroupName

Jeux de paramètres

UpdateExpanded
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceGroupName

Nom du groupe de ressources. Le nom ne respecte pas la casse.

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

UpdateExpanded
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SmsReceiver

Liste des récepteurs SMS qui font partie de ce groupe d’actions.

Propriétés du paramètre

Type:

ISmsReceiver[]

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

-SubscriptionId

ID de l’abonnement cible.

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

UpdateExpanded
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Tag

Étiquettes de ressources

Propriétés du paramètre

Type:Hashtable
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

-VoiceReceiver

Liste des récepteurs vocaux qui font partie de ce groupe d’actions.

Propriétés du paramètre

Type:

IVoiceReceiver[]

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

-WebhookReceiver

Liste des récepteurs webhook qui font partie de ce groupe d’actions.

Propriétés du paramètre

Type:

IWebhookReceiver[]

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

-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.

Entrées

IActionGroupIdentity

Sorties

IActionGroupResource