New-AzSentinelBookmark
Creates or updates the bookmark.
Syntax
New-AzSentinelBookmark
-ResourceGroupName <String>
-WorkspaceName <String>
[-Id <String>]
[-SubscriptionId <String>]
[-DisplayName <String>]
[-EventTime <DateTime>]
[-IncidentInfoIncidentId <String>]
[-IncidentInfoRelationName <String>]
[-IncidentInfoSeverity <IncidentSeverity>]
[-IncidentInfoTitle <String>]
[-Label <String[]>]
[-Note <String>]
[-Query <String>]
[-QueryEndTime <DateTime>]
[-QueryResult <String>]
[-QueryStartTime <DateTime>]
[-DefaultProfile <PSObject>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
New-AzSentinelBookmark
-ResourceGroupName <String>
-WorkspaceName <String>
-Bookmark <IBookmark>
[-Id <String>]
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Creates or updates the bookmark.
Examples
Example 1: Create a Bookmark
$queryStartTime = (Get-Date).AddDays(-1).ToUniversalTime() | Get-Date -Format "yyyy-MM-ddThh:00:00.000Z"
$queryEndTime = (Get-Date).ToUniversalTime() | Get-Date -Format "yyyy-MM-ddThh:00:00.000Z"
New-AzSentinelBookmark -ResourceGroupName "myResourceGroup" -WorkspaceName "myWorkspaceName" -Id ((New-Guid).Guid) -DisplayName "Incident Evidence" -Query "SecurityEvent | take 1" -QueryStartTime $queryStartTime -QueryEndTime $queryEndTime -EventTime $queryEndTime
DisplayName : Incident Evidence
CreatedByName : John Contoso
CreatedByEmail : john@contoso.com
Name : 6a8d6ea6-04d5-49d7-8169-ffca8b0ced59
Note : my notes
This command creates a Bookmark.
Parameters
-Bookmark
Represents a bookmark in Azure Security Insights. To construct, see NOTES section for BOOKMARK properties and create a hash table.
Type: | IBookmark |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
The DefaultProfile parameter is not functional. Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.
Type: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
The display name of the bookmark
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EventTime
The bookmark event time
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Bookmark ID
Type: | String |
Aliases: | BookmarkId |
Position: | Named |
Default value: | (New-Guid).Guid |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncidentInfoIncidentId
Incident Id
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncidentInfoRelationName
Relation Name
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncidentInfoSeverity
The severity of the incident
Type: | IncidentSeverity |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncidentInfoTitle
The title of the incident
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Label
List of labels relevant to this bookmark
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Note
The notes of the bookmark
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Query
The query of the bookmark.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-QueryEndTime
The end time for the query
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-QueryResult
The query result of the bookmark.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-QueryStartTime
The start time for the query
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
The name of the resource group. The name is case insensitive.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
The ID of the target subscription.
Type: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkspaceName
The name of the workspace.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
Outputs
Notes
ALIASES
COMPLEX PARAMETER PROPERTIES
To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.
BOOKMARK <IBookmark>
: Represents a bookmark in Azure Security Insights.
[Etag <String>]
: Etag of the azure resource[SystemDataCreatedAt <DateTime?>]
: The timestamp of resource creation (UTC).[SystemDataCreatedBy <String>]
: The identity that created the resource.[SystemDataCreatedByType <CreatedByType?>]
: The type of identity that created the resource.[SystemDataLastModifiedAt <DateTime?>]
: The timestamp of resource last modification (UTC)[SystemDataLastModifiedBy <String>]
: The identity that last modified the resource.[SystemDataLastModifiedByType <CreatedByType?>]
: The type of identity that last modified the resource.[Created <DateTime?>]
: The time the bookmark was created[CreatedByObjectId <String>]
: The object id of the user.[DisplayName <String>]
: The display name of the bookmark[EventTime <DateTime?>]
: The bookmark event time[IncidentInfoIncidentId <String>]
: Incident Id[IncidentInfoRelationName <String>]
: Relation Name[IncidentInfoSeverity <IncidentSeverity?>]
: The severity of the incident[IncidentInfoTitle <String>]
: The title of the incident[Label <String[]>]
: List of labels relevant to this bookmark[Note <String>]
: The notes of the bookmark[Query <String>]
: The query of the bookmark.[QueryEndTime <DateTime?>]
: The end time for the query[QueryResult <String>]
: The query result of the bookmark.[QueryStartTime <DateTime?>]
: The start time for the query[Updated <DateTime?>]
: The last time the bookmark was updated[UpdatedByObjectId <String>]
: The object id of the user.
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for