你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Set-AzDataCollectionRule
汇报(完全替换)数据收集规则。
语法
Set-AzDataCollectionRule
-Location <String>
-ResourceGroupName <String>
-RuleName <String>
-RuleFile <String>
[-Description <String>]
[-Tag <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzDataCollectionRule
-Location <String>
-RuleId <String>
-RuleFile <String>
[-Description <String>]
[-Tag <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzDataCollectionRule
-InputObject <PSDataCollectionRuleResource>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Set-AzDataCollectionRule cmdlet 替换了现有的数据收集规则。
数据收集规则 (DCR) 定义传入 Azure Monitor 的数据,并指定应发送或存储数据的位置。 下面是完整的 DCR 概述文章。
若要使用 -RuleFile 参数,请构造包含三个属性的 json 文件:dataSources、destinations、dataFlows(请参阅示例 #1)。
可以在此处 找到架构详细信息。
还支持使用 cmdlet ConvertTo-Json 序列化的 DCR 的输出(示例 #2)。
示例
示例 1:更新数据收集规则、Rest API 中的 JSON
Set-AzDataCollectionRule -Location 'East US 2 EUAP' `
-ResourceGroupName 'testdcr' `
-RuleName 'newDcr' `
-RuleFile 'C:\samples\dcr1.json' `
-Description 'Updated Description'
Description : Updated Description
DataSources : Microsoft.Azure.Commands.Insights.OutputClasses.PSDataCollectionRuleDataSources
Destinations : Microsoft.Azure.Commands.Insights.OutputClasses.PSDataCollectionRuleDestinations
DataFlows : {Microsoft.Azure.Commands.Insights.OutputClasses.PSDataFlow}
ProvisioningState : Succeeded
Etag : "{etag}"
Id : /subscriptions/{subId}/resourceGroups/testdcr/providers/Microsoft.Insights/dataCollectionRules/newDcr
Name : newDcr
Type : Microsoft.Insights/dataCollectionRules
Location : East US 2 EUAP
Tags : {[tag2, value2], [tag1, value1]}
# Note: Content of C:\samples\dcr1.json
{
"properties": {
"dataSources": {
"performanceCounters": [
{
"streams": [
"Microsoft-InsightsMetrics"
],
"scheduledTransferPeriod": "PT1M",
"samplingFrequencyInSeconds": 10,
"counterSpecifiers": [
"\\Processor Information(_Total)\\% Processor Time"
],
"name": "perfCounter01"
}
]
},
"destinations": {
"azureMonitorMetrics": {
"name": "azureMonitorMetrics-default"
}
},
"dataFlows": [
{
"streams": [
"Microsoft-InsightsMetrics"
],
"destinations": [
"azureMonitorMetrics-default"
]
}
]
}
}
此命令替换当前订阅的现有数据收集规则。
示例 2:更新数据收集规则、PSDataCollectionRuleResource 中的 JSON
Set-AzDataCollectionRule -Location 'East US 2 EUAP' `
-RuleId '/subscriptions/{subId}/resourceGroups/testdcr/providers/Microsoft.Insights/dataCollectionRules/newDcr' `
-RuleFile 'C:\samples\dcr2.json' `
-Description 'Updated Description'
Description : Updated Description
DataSources : Microsoft.Azure.Commands.Insights.OutputClasses.PSDataCollectionRuleDataSources
Destinations : Microsoft.Azure.Commands.Insights.OutputClasses.PSDataCollectionRuleDestinations
DataFlows : {Microsoft.Azure.Commands.Insights.OutputClasses.PSDataFlow}
ProvisioningState : Succeeded
Etag : "{etag}"
Id : /subscriptions/{subId}/resourceGroups/testdcr/providers/Microsoft.Insights/dataCollectionRules/newDcr
Name : newDcr
Type : Microsoft.Insights/dataCollectionRules
Location : East US 2 EUAP
Tags : {[tag2, value2], [tag1, value1]}
# Note: Content of C:\samples\dcr2.json
{
"DataSources": {
"PerformanceCounters": [
{
"Streams": [
"Microsoft-InsightsMetrics"
],
"ScheduledTransferPeriod": "PT1M",
"SamplingFrequencyInSeconds": 10,
"CounterSpecifiers": [
"\\Processor Information(_Total)\\% Processor Time"
],
"Name": "perfCounter01"
}
]
},
"Destinations": {
"AzureMonitorMetrics": {
"Name": "azureMonitorMetrics-default"
}
},
"DataFlows": [
{
"Streams": [
"Microsoft-InsightsMetrics"
],
"Destinations": [
"azureMonitorMetrics-default"
]
}
]
}
此命令替换当前订阅的现有数据收集规则。
示例 3:从对象更新数据收集规则
$dcr = Get-AzDataCollectionRule -ResourceGroupName "testdcr" -Name "newDcr"
$dcr.Description = 'This is a test'
$dcr | Set-AzDataCollectionRule
Description : This is a test
DataSources : Microsoft.Azure.Commands.Insights.OutputClasses.PSDataCollectionRuleDataSources
Destinations : Microsoft.Azure.Commands.Insights.OutputClasses.PSDataCollectionRuleDestinations
DataFlows : {Microsoft.Azure.Commands.Insights.OutputClasses.PSDataFlow}
ProvisioningState : {provState}
Etag : "{etag}"
Id : /subscriptions/{subId}/resourceGroups/testdcr/providers/Microsoft.Insights/dataCollectionRules/newDcr
Name : newDcr
Type : Microsoft.Insights/dataCollectionRules
Location : East US 2 EUAP
Tags : {[tag2, value2], [tag1, value1]}
从对象更新数据收集规则
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
用于与 azure 通信的凭据、帐户、租户和订阅
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
资源说明
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
PSDataCollectionRuleResource 对象
Type: | PSDataCollectionRuleResource |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
资源位置
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
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 |
-RuleFile
JSON 文件路径
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RuleId
资源 ID
Type: | String |
Aliases: | ResourceId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RuleName
资源名称
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
资源标记
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |