Delen via

Set-AzActivityLogAlert

  • Referentie
Module:
Az.Monitor

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

Syntaxis

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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

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

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

De beschrijving van de waarschuwingsresource.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Location

De locatie waar de waarschuwing voor het activiteitenlogboek bestaat.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

De naam van de waarschuwing voor het activiteitenlogboek.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

De naam van de resourcegroep waar de waarschuwingsresource gaat bestaan.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Scope

De lijst met bereiken voor de waarschuwing voor het activiteitenlogboek.

Type:List<T>[String]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

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

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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