Set-AzDataCollectionRule
Veri toplama kuralını (tam değiştirme) Güncelleştirmeler.
Syntax
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>]
Description
Set-AzDataCollectionRule cmdlet'i var olan bir veri toplama kuralının yerini alır.
Veri Toplama Kuralları (DCR), Azure İzleyici'ye gelen verileri tanımlar ve verilerin nereye gönderilmesi veya depolanması gerektiğini belirtir. DCR'ye genel bakış makalesinin tamamı aşağıda verilmiştir.
-RuleFile parametresini kullanmak için üç özellik içeren bir json dosyası oluşturun: dataSources, destinations, dataFlows (bkz. Örnek #1).
Şema ayrıntılarını burada bulabilirsiniz.
ConvertTo-Json cmdlet'iyle seri hale getirilmiş bir DCR çıkışı da desteklenir (Örnek #2).
Örnekler
Örnek 1: Rest API'den JSON veri toplama kuralını güncelleştirme
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"
]
}
]
}
}
Bu komut, geçerli abonelik için mevcut veri toplama kurallarının yerini alır.
Örnek 2: PSDataCollectionRuleResource'tan JSON veri toplama kuralını güncelleştirme
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"
]
}
]
}
Bu komut, geçerli abonelik için mevcut veri toplama kurallarının yerini alır.
Örnek 3: Nesneden veri toplama kuralını güncelleştirme
$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]}
Nesneden veri toplama kuralını güncelleştirme
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Kaynak açıklaması
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
PSDataCollectionRuleResource Nesnesi
Type: | PSDataCollectionRuleResource |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
Kaynak konumu
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Kaynak grubu adı
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RuleFile
JSON dosya yolu
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RuleId
Kaynak kimliği
Type: | String |
Aliases: | ResourceId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RuleName
Kaynak adı
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Kaynak etiketleri
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |