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

New-AzDataCollectionRuleAssociation

  • 参考
模块:
Az.Monitor

创建数据收集规则关联。

语法

New-AzDataCollectionRuleAssociation
   -TargetResourceId <String>
   -AssociationName <String>
   -RuleId <String>
   [-Description <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDataCollectionRuleAssociation
   -TargetResourceId <String>
   -AssociationName <String>
   [-Description <String>]
   -InputObject <PSDataCollectionRuleResource>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzDataCollectionRuleAssociation cmdlet (DCRA) 创建数据收集规则关联。

若要将 DCR 应用于虚拟机，请为虚拟机创建关联。 虚拟机可能与多个 DCR 存在关联，而 DCR 可能有多个虚拟机与之关联。 这使你可以定义一组 DCR（每个都与特定要求匹配），并只将它们应用于它们适用的虚拟机。 下面是使用 DCRA 为 Azure Monitor 代理配置数据收集一 文。

示例

示例 1：创建数据收集规则关联

$dcr = Get-AzDataCollectionRule -ResourceGroupName $rg -RuleName $dcrName
$vmId = '/subscriptions/{subId}/resourceGroups/{resourcegroup}/providers/Microsoft.Compute/virtualMachines/{vmName}'
New-AzDataCollectionRuleAssociation -TargetResourceId $vmId -AssociationName "dcrAssoc" -RuleId $dcr.Id

Description          :
DataCollectionRuleId : /subscriptions/{subId}/resourceGroups/{resourcegroup}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}
ProvisioningState    :
Etag                 : "{etag}"
Id                   : /subscriptions/{subId}/resourceGroups/{resourcegroup}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.Insights/dataCollectionRuleAssociations/dcrAssoc
Name                 : dcrAssoc
Type                 : Microsoft.Insights/dataCollectionRuleAssociations

此命令为给定规则和目标资源 ID 创建数据收集规则关联。

示例 2：从 DCR 对象创建数据收集规则关联

$dcr = Get-AzDataCollectionRule -ResourceGroupName $rg -RuleName $dcrName
$vmId = '/subscriptions/{subId}/resourceGroups/{resourcegroup}/providers/Microsoft.Compute/virtualMachines/{vmName}'
$dcr | New-AzDataCollectionRuleAssociation -TargetResourceId $vmId -AssociationName "dcrAssocInput"

Description          :
DataCollectionRuleId : /subscriptions/{subId}/resourceGroups/{resourcegroup}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}
ProvisioningState    :
Etag                 : "{etag}"
Id                   : /subscriptions/{subId}/resourceGroups/{resourcegroup}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.Insights/dataCollectionRuleAssociations/dcrAssocInput
Name                 : dcrAssocInput
Type                 : Microsoft.Insights/dataCollectionRuleAssociations

此命令为给定规则和目标资源 ID 创建数据收集规则关联。

参数

-AssociationName

资源名称

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅

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

-Description

资源说明

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

-InputObject

PSDataCollectionRuleResource 对象

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

-RuleId

数据收集规则 ID

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

-TargetResourceId

要关联的资源 ID

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

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

输入

String

输出

PSDataCollectionRuleAssociationProxyOnlyResource