Sdílet prostřednictvím

Update-AzActionGroup

  • Reference
Modul:
Az.Monitor

Aktualizujte novou skupinu akcí nebo aktualizujte existující.

Syntaxe

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

Aktualizujte novou skupinu akcí nebo aktualizujte existující.

Příklady

Příklad 1: Přidání příjemce do zadané skupiny akcí

$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": "00001111-aaaa-2222-bbbb-3333cccc4444",
                              "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           : {}

Tento příkaz aktualizuje zadanou skupinu akcí s názvem a skupinou.

Příklad 2: Odstranění příjemce do zadané skupiny akcí

$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           : {}

První příkaz získá zadanou skupinu akcí. Poslední příkaz aktualizuje zadanou skupinu akcí objektem skupiny akcí.

Parametry

-ArmRoleReceiver

Seznam příjemců rolí ARM, kteří jsou součástí této skupiny akcí. Role jsou role Azure RBAC a podporují se jenom předdefinované role.

Typ:IArmRoleReceiver[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AutomationRunbookReceiver

Seznam příjemců služby AutomationRunbook, které jsou součástí této skupiny akcí.

Typ:IAutomationRunbookReceiver[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AzureAppPushReceiver

Seznam příjemců AzureAppPush, kteří jsou součástí této skupiny akcí.

Typ:IAzureAppPushReceiver[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AzureFunctionReceiver

Seznam příjemců funkcí Azure, kteří jsou součástí této skupiny akcí.

Typ:IAzureFunctionReceiver[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Parametr DefaultProfile není funkční. Pokud je k dispozici spuštění rutiny pro jiné předplatné, použijte parametr SubscriptionId.

Typ:PSObject
Aliasy:AzureRMContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EmailReceiver

Seznam příjemců e-mailu, kteří jsou součástí této skupiny akcí.

Typ:IEmailReceiver[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Enabled

Určuje, jestli je tato skupina akcí povolená. Pokud skupina akcí není povolená, žádná z jejích příjemců nebude přijímat komunikaci.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EventHubReceiver

Seznam příjemců centra událostí, které jsou součástí této skupiny akcí.

Typ:IEventHubReceiver[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GroupShortName

Krátký název skupiny akcí. Použije se ve zprávách SMS.

Typ:String
Aliasy:ShortName
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Parametr identity

Typ:IActionGroupIdentity
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ItsmReceiver

Seznam příjemců ITSM, kteří jsou součástí této skupiny akcí.

Typ:IItsmReceiver[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LogicAppReceiver

Seznam příjemců aplikace logiky, které jsou součástí této skupiny akcí.

Typ:ILogicAppReceiver[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Název skupiny akcí.

Typ:String
Aliasy:ActionGroupName
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Název skupiny zdrojů. Název nerozlišuje malá a velká písmena.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SmsReceiver

Seznam příjemců sms, které jsou součástí této skupiny akcí.

Typ:ISmsReceiver[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SubscriptionId

ID cílového předplatného.

Typ:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tag

Značky prostředků

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VoiceReceiver

Seznam hlasových přijímačů, které jsou součástí této skupiny akcí.

Typ:IVoiceReceiver[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WebhookReceiver

Seznam příjemců webhooků, kteří jsou součástí této skupiny akcí.

Typ:IWebhookReceiver[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

IActionGroupIdentity

Výstupy

IActionGroupResource