New-AzActionGroup

Modul:

Az.Monitor

Erstellen Sie eine neue Aktionsgruppe, oder aktualisieren Sie eine vorhandene.

Syntax

New-AzActionGroup
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <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>]

New-AzActionGroup
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -JsonString <String>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzActionGroup
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -JsonFilePath <String>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzActionGroup
   -InputObject <IActionGroupIdentity>
   -Location <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>]

Beschreibung

Erstellen Sie eine neue Aktionsgruppe, oder aktualisieren Sie eine vorhandene.

Beispiele

Beispiel 1: Erstellen einer Aktionsgruppe

$email1 = New-AzActionGroupEmailReceiverObject -EmailAddress user@example.com -Name user1
$sms1 = New-AzActionGroupSmsReceiverObject -CountryCode '{countrycode}' -Name user2 -PhoneNumber '{phonenumber}'
New-AzActionGroup -Name 'actiongroup1' -ResourceGroupName 'Monitor-Action' -Location northcentralus -GroupShortName ag1 -EmailReceiver $email1 -SmsReceiver $sms1

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

Die ersten beiden Befehle erstellen zwei Empfänger. Der letzte Befehl erstellt eine Aktionsgruppe einschließlich der beiden Empfänger.

Beispiel 2: Erstellen einer anderen Aktionsgruppe

New-AzActionGroup -Name 'actiongroup1' -ResourceGroupName 'Monitor-Action' -Location northcentralus -GroupShortName ag1

ArmRoleReceiver           : {}
AutomationRunbookReceiver : {}
AzureAppPushReceiver      : {}
AzureFunctionReceiver     : {}
EmailReceiver             : {}
Enabled                   : False
EventHubReceiver          : {}
GroupShortName            : ag1
Id                        : /subscriptions/{subid}/resourceGroups/Monitor-Action/providers/microsoft.insights/actionGroups/actiongroup1
ItsmReceiver              : {}
Location                  : northcentralus
LogicAppReceiver          : {}
Name                      : actiongroup1
ResourceGroupName         : Monitor-Action
SmsReceiver               : {}
Tag                       : {
                            }
Type                      : Microsoft.Insights/ActionGroups
VoiceReceiver             : {}
WebhookReceiver           : {}

Mit diesem Befehl wird eine Aktionsgruppe ohne Empfänger erstellt.

Parameter

-ArmRoleReceiver

Die Liste der ARM-Rollenempfänger, die Teil dieser Aktionsgruppe sind. Rollen sind Azure RBAC-Rollen und nur integrierte Rollen werden unterstützt. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für ARMROLERECEIVER-Eigenschaften und erstellen eine Hashtabelle.

Type:	IArmRoleReceiver[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutomationRunbookReceiver

Die Liste der AutomationRunbook-Empfänger, die Teil dieser Aktionsgruppe sind. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für AUTOMATIONRUNBOOKRECEIVER-Eigenschaften und erstellen eine Hashtabelle.

Type:	IAutomationRunbookReceiver[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AzureAppPushReceiver

Die Liste der AzureAppPush-Empfänger, die Teil dieser Aktionsgruppe sind. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für AZUREAPPPUSHRECEIVER-Eigenschaften und erstellen eine Hashtabelle.

Type:	IAzureAppPushReceiver[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AzureFunctionReceiver

Die Liste der Azure-Funktionsempfänger, die Teil dieser Aktionsgruppe sind. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für AZUREFUNCTIONRECEIVER-Eigenschaften und erstellen eine Hashtabelle.

Type:	IAzureFunctionReceiver[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EmailReceiver

Die Liste der E-Mail-Empfänger, die Teil dieser Aktionsgruppe sind. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für EMAILRECEIVER-Eigenschaften und erstellen eine Hashtabelle.

Type:	IEmailReceiver[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Enabled

Gibt an, ob diese Aktionsgruppe aktiviert ist. Wenn eine Aktionsgruppe nicht aktiviert ist, empfängt keiner seiner Empfänger Kommunikationen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EventHubReceiver

Die Liste der Ereignishubempfänger, die Teil dieser Aktionsgruppe sind. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für EVENTHUBRECEIVER-Eigenschaften und erstellen eine Hashtabelle.

Type:	IEventHubReceiver[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GroupShortName

Der kurze Name der Aktionsgruppe. Dies wird in SMS-Nachrichten verwendet.

Type:	String
Aliases:	ShortName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

Type:	IActionGroupIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ItsmReceiver

Die Liste der ITSM-Empfänger, die Teil dieser Aktionsgruppe sind. Informationen zum Erstellen finden Sie im ABSCHNITT NOTES für ITSMRECEIVER-Eigenschaften und erstellen eine Hashtabelle.

Type:	IItsmReceiver[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JsonFilePath

Pfad der JSON-Datei, die für den Erstellungsvorgang bereitgestellt wird

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JsonString

Json-Zeichenfolge, die für den Create-Vorgang bereitgestellt wird

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Ressourcenspeicherort

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LogicAppReceiver

Die Liste der Logik-App-Empfänger, die Teil dieser Aktionsgruppe sind. Informationen zum Erstellen finden Sie im ABSCHNITT NOTES für LOGICAPPRECEIVER-Eigenschaften und erstellen eine Hashtabelle.

Type:	ILogicAppReceiver[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Der Name der Aktionsgruppe.

Type:	String
Aliases:	ActionGroupName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SmsReceiver

Die Liste der SMS-Empfänger, die Teil dieser Aktionsgruppe sind. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für SMSRECEIVER-Eigenschaften und erstellen eine Hashtabelle.

Type:	ISmsReceiver[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Hierbei handelt es sich um die ID des Zielabonnements.

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Ressourcentags

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VoiceReceiver

Die Liste der Sprachempfänger, die Teil dieser Aktionsgruppe sind. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für VOICERECEIVER-Eigenschaften und erstellen eine Hashtabelle.

Type:	IVoiceReceiver[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WebhookReceiver

Die Liste der Webhook-Empfänger, die Teil dieser Aktionsgruppe sind. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für WEBHOOKRECEIVER-Eigenschaften und erstellen eine Hashtabelle.

Type:	IWebhookReceiver[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

IActionGroupIdentity

Ausgaben

IActionGroupResource