你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AzSentinelEntityQuery

获取实体查询。

语法

Get-AzSentinelEntityQuery
   -ResourceGroupName <String>
   -WorkspaceName <String>
   [-SubscriptionId <String[]>]
   [-Kind <String>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzSentinelEntityQuery
   -Id <String>
   -ResourceGroupName <String>
   -WorkspaceName <String>
   [-SubscriptionId <String[]>]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzSentinelEntityQuery
   -InputObject <ISecurityInsightsIdentity>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

说明

获取实体查询。

示例

示例 1:列出所有实体查询

Get-AzSentinelEntityQuery -ResourceGroupName "myResourceGroupName" -workspaceName "myWorkspaceName"

DisplayName     : Related entities
DataSource      : {SecurityAlert}
Name            : 98b974fd-cc64-48b8-9bd0-3a209f5b944b
InputEntityType : SecurityAlert

DisplayName     : Related alerts
DataSource      : {SecurityAlert}
Name            : 055a5692-555f-42bd-ac17-923a5a9994ed
InputEntityType : Host

此命令列出 Microsoft Sentinel 工作区下的所有实体查询。

示例 2:获取实体查询

Get-AzSentinelEntityQuery -ResourceGroupName "myResourceGroupName" -workspaceName "myWorkspaceName" -Id "myEntityQueryId"

DisplayName     : Related entities
DataSource      : {SecurityAlert}
Name            : 98b974fd-cc64-48b8-9bd0-3a209f5b944b
InputEntityType : SecurityAlert
QueryTemplate   : let GetAlertRelatedEntities = (v_SecurityAlert_SystemAlertId:string){
                                              SecurityAlert
                                              | where SystemAlertId == v_SecurityAlert_SystemAlertId
                                              | project entities = todynamic(Entities)
                                              | mv-expand entities
                                              | project-rename entity=entities};
                                              GetAlertRelatedEntities('<systemAlertId>')

此命令获取实体查询。

示例 3:按对象 ID 获取实体查询

$EntityQueries = Get-AzSentinelEntityQuery -ResourceGroupName "myResourceGroupName" -workspaceName "myWorkspaceName"
 $EntityQueries[0] | Get-AzSentinelEntityQuery

DisplayName     : Related entities
DataSource      : {SecurityAlert}
Name            : 98b974fd-cc64-48b8-9bd0-3a209f5b944b
InputEntityType : SecurityAlert
QueryTemplate   : let GetAlertRelatedEntities = (v_SecurityAlert_SystemAlertId:string){
                                              SecurityAlert
                                              | where SystemAlertId == v_SecurityAlert_SystemAlertId
                                              | project entities = todynamic(Entities)
                                              | mv-expand entities
                                              | project-rename entity=entities};
                                              GetAlertRelatedEntities('<systemAlertId>')

此命令按对象获取实体查询。

参数

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet,请使用 SubscriptionId 参数。

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

-Id

实体查询 ID

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

-InputObject

要构造的标识参数,请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

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

-Kind

要提取的实体查询类型

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

-ResourceGroupName

资源组的名称。 此名称不区分大小写。

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

-SubscriptionId

目标订阅的 ID。

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

-WorkspaceName

工作区的名称。

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

输入

ISecurityInsightsIdentity

输出

IEntityQuery

备注

别名

复杂参数属性

若要创建下面所述的参数,请构造一个包含相应属性的哈希表。 有关哈希表的信息,请运行 Get-Help about_Hash_Tables。

INPUTOBJECT <ISecurityInsightsIdentity>:标识参数

  • [ActionId <String>]:操作 ID
  • [AlertRuleTemplateId <String>]:警报规则模板 ID
  • [AutomationRuleId <String>]:自动化规则 ID
  • [BookmarkId <String>]:书签 ID
  • [ConsentId <String>]:同意 ID
  • [DataConnectorId <String>]:连接or ID
  • [EntityId <String>]:实体 ID
  • [EntityQueryId <String>]:实体查询 ID
  • [EntityQueryTemplateId <String>]:实体查询模板 ID
  • [Id <String>]:资源标识路径
  • [IncidentCommentId <String>]:事件注释 ID
  • [IncidentId <String>]:事件 ID
  • [MetadataName <String>]:元数据名称。
  • [Name <String>]:威胁情报指示器名称字段。
  • [RelationName <String>]:关系名称
  • [ResourceGroupName <String>]:资源组的名称。 此名称不区分大小写。
  • [RuleId <String>]:警报规则 ID
  • [SentinelOnboardingStateName <String>]:Sentinel 载入状态名称。 支持 - 默认值
  • [SettingsName <String>]:设置名称。 支持 - 异常、EyesOn、EntityAnalytics、Ueba
  • [SourceControlId <String>]:源代码管理 ID
  • [SubscriptionId <String>]:目标订阅的 ID。
  • [WorkspaceName <String>]:工作区的名称。