Set-AzActivityLogAlert

  • Referentie
Module:
Az.Monitor

Hiermee maakt u een nieuwe waarschuwing of stelt u een bestaande waarschuwing voor activiteitenlogboeken in.

Syntax

Set-AzActivityLogAlert
   -Location <String>
   -Name <String>
   -ResourceGroupName <String>
   -Scope <System.Collections.Generic.List`1[System.String]>
   -Condition <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertLeafCondition]>
   -Action <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertActionGroup]>
   [-DisableAlert]
   [-Description <String>]
   [-Tag <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzActivityLogAlert
   [-Location <String>]
   [-Scope <System.Collections.Generic.List`1[System.String]>]
   [-Condition <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertLeafCondition]>]
   [-Action <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertActionGroup]>]
   [-DisableAlert]
   [-Description <String>]
   [-Tag <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   -ResourceId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzActivityLogAlert
   [-Scope <System.Collections.Generic.List`1[System.String]>]
   [-Condition <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertLeafCondition]>]
   [-Action <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertActionGroup]>]
   [-Description <String>]
   [-Tag <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   -InputObject <PSActivityLogAlertResource>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Met de cmdlet Set-AzActivityLogAlert maakt u een nieuwe of stelt u een bestaande waarschuwing voor activiteitenlogboeken in. Voor tags, voorwaarden en acties moeten de objecten vooraf worden gemaakt en als parameters in deze aanroep worden doorgegeven als door komma's gescheiden (zie het onderstaande voorbeeld). Met deze cmdlet wordt het ShouldProcess-patroon geïmplementeerd. Het kan bijvoorbeeld een bevestiging van de gebruiker aanvragen voordat de resource daadwerkelijk wordt gemaakt/gewijzigd. OPMERKING: Deze cmdlet en de bijbehorende cmdlets vervangen de afgeschafte (november 2017) Add-AzLogAlertRule.

Voorbeelden

Voorbeeld 1: Een waarschuwing voor activiteitenlogboek maken

PS C:\>$location = 'Global'
PS C:\>$alertName = 'myAlert'
PS C:\>$resourceGroupName = 'theResourceGroupName'
PS C:\>$condition1 = New-AzActivityLogAlertCondition -Field 'field1' -Equal 'equals1'
PS C:\>$condition2 = New-AzActivityLogAlertCondition -Field 'field2' -Equal 'equals2'
PS C:\>$dict = New-Object "System.Collections.Generic.Dictionary``2[System.String,System.String]"
PS C:\>$dict.Add('key1', 'value1')
PS C:\>$actionGrp1 = New-AzActionGroup -ActionGroupId 'actiongr1' -WebhookProperty $dict
PS C:\>Set-AzActivityLogAlert -Location $location -Name $alertName -ResourceGroupName $resourceGroupName -Scope 'scope1','scope2' -Action $actionGrp1 -Condition $condition1, $condition2

Met de eerste vier opdrachten maakt u bladvoorwaarde en actiegroep. Met de laatste opdracht maakt u een waarschuwing voor activiteitenlogboek met behulp van de voorwaarde en de actiegroep.

Voorbeeld 2: Een waarschuwing voor activiteitenlogboeken maken uitgeschakeld

PS C:\>$location = 'Global'
PS C:\>$alertName = 'myAlert'
PS C:\>$resourceGroupName = 'theResourceGroupName'
PS C:\>$condition1 = New-AzActivityLogAlertCondition -Field 'field1' -Equal 'equals1'
PS C:\>$condition2 = New-AzActivityLogAlertCondition -Field 'field2' -Equal 'equals2'
PS C:\>$dict = New-Object "System.Collections.Generic.Dictionary``2[System.String,System.String]"
PS C:\>$dict.Add('key1', 'value1')
PS C:\>$actionGrp1 = New-AzActionGroup -ActionGroupId 'actiongr1' -WebhookProperty $dict
PS C:\>Set-AzActivityLogAlert -Location $location -Name $alertName -ResourceGroupName $resourceGroupName -Scope 'scope1','scope2' -Action $actionGrp1 -Condition $condition1, $condition2 -DisableAlert

Met de eerste vier opdrachten maakt u bladvoorwaarde en actiegroep. Met de laatste opdracht maakt u een waarschuwing voor activiteitenlogboek met behulp van de voorwaarde en de actiegroep, maar wordt de waarschuwing uitgeschakeld.

Voorbeeld 3: Een waarschuwing voor activiteitenlogboeken instellen op basis van een waarde uit de pipe of de parameter InputObject

PS C:\>Get-AzActivityLogAlert -Name $alertName -ResourceGroupName $resourceGroupName | Set-AzActivityLogAlert
PS C:\>$alert = Get-AzActivityLogAlert -Name $alertName -ResourceGroupName $resourceGroupName
PS C:\>$alert.Description = 'Changing the description'
PS C:\>$alert.Enabled = $false
PS C:\>Set-AzActivityLogAlert -InputObject $alert

De eerste opdracht is vergelijkbaar met een nop, het stelt de waarschuwing in met dezelfde waarden als die al de rest van de opdrachten bevat de waarschuwingsregel ophalen, de beschrijving wijzigen en uitschakelen, en vervolgens de parameter InputObject gebruiken om deze wijzigingen te behouden

Voorbeeld 4: Een waarschuwing voor activiteitenlogboeken instellen op basis van de ResourceId-waarde uit de pijp

PS C:\>Get-AzResource -ResourceGroupName "myResourceGroup" -Name "myLogAlert" | Set-AzActivityLogAlert -DisableAlert

Als de opgegeven waarschuwingsregel voor logboeken bestaat, wordt deze door deze opdracht uitgeschakeld.

Parameters

-Action

De lijst met actiegroepen voor de waarschuwing voor het activiteitenlogboek.

Type:List<T>[ActivityLogAlertActionGroup]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Condition

De lijst met voorwaarden voor de waarschuwing voor het activiteitenlogboek. OPMERKING: In de lijst met voorwaarden moet er ten minste één zijn met het veld gelijk aan 'Categorie'. De back-end reageert met 400 (BadRequest) als deze voorwaarde niet aanwezig is.

Type:List<T>[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertLeafCondition]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

De beschrijving van de waarschuwingsresource.

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

-DisableAlert

Hiermee kan de gebruiker een uitgeschakelde waarschuwing voor het activiteitenlogboek maken. Als dit niet is opgegeven, worden de waarschuwingen ingeschakeld.

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

-InputObject

Hiermee stelt u de eigenschap InputObject-tags van de aanroep in om de vereiste naam en eigenschappen van de resourcegroepnaam op te halen.

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

-Location

De locatie waar de waarschuwing voor het activiteitenlogboek bestaat.

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

-Name

De naam van de waarschuwing voor het activiteitenlogboek.

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

-ResourceGroupName

De naam van de resourcegroep waar de waarschuwingsresource gaat bestaan.

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

-ResourceId

Hiermee stelt u de eigenschap ResourceId-tags van de aanroep in om de vereiste naam, eigenschappen van de resourcegroepnaam op te halen.

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

-Scope

De lijst met bereiken voor de waarschuwing voor het activiteitenlogboek.

Type:List<T>[String]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Hiermee stelt u de eigenschap tags van de waarschuwingsresource voor het activiteitenlogboek in.

Type:Dictionary<TKey,TValue>[System.String,System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

String

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

List<T>[[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertLeafCondition, Microsoft.Azure.PowerShell.Cmdlets.Monitor, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Management.Monitor.Management.Models.ActivityLogAlertActionGroup, Microsoft.Azure.PowerShell.Cmdlets.Monitor, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

Dictionary<TKey,TValue>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e],[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

PSActivityLogAlertResource

Uitvoerwaarden

PSActivityLogAlertResource