Udostępnij przez

Update-AzDataCollectionRule

Moduł:
Az.Monitor Module

Aktualizowanie reguły zbierania danych.

Składnia

UpdateExpanded (Domyślne) 

Update-AzDataCollectionRule
    -Name <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-DataCollectionEndpointId <String>]
    [-DataFlow <IDataFlow[]>]
    [-DataSourceDataImportEventHubConsumerGroup <String>]
    [-DataSourceDataImportEventHubName <String>]
    [-DataSourceDataImportEventHubStream <String>]
    [-DataSourceExtension <IExtensionDataSource[]>]
    [-DataSourceIisLog <IIisLogsDataSource[]>]
    [-DataSourceLogFile <ILogFilesDataSource[]>]
    [-DataSourcePerformanceCounter <IPerfCounterDataSource[]>]
    [-DataSourcePlatformTelemetry <IPlatformTelemetryDataSource[]>]
    [-DataSourcePrometheusForwarder <IPrometheusForwarderDataSource[]>]
    [-DataSourceSyslog <ISyslogDataSource[]>]
    [-DataSourceWindowsEventLog <IWindowsEventLogDataSource[]>]
    [-DataSourceWindowsFirewallLog <IWindowsFirewallLogsDataSource[]>]
    [-Description <String>]
    [-DestinationAzureMonitorMetricName <String>]
    [-DestinationEventHub <IEventHubDestination[]>]
    [-DestinationEventHubsDirect <IEventHubDirectDestination[]>]
    [-DestinationLogAnalytic <ILogAnalyticsDestination[]>]
    [-DestinationMonitoringAccount <IMonitoringAccountDestination[]>]
    [-DestinationStorageAccount <IStorageBlobDestination[]>]
    [-DestinationStorageBlobsDirect <IStorageBlobDestination[]>]
    [-DestinationStorageTablesDirect <IStorageTableDestination[]>]
    [-EnableSystemAssignedIdentity <Boolean>]
    [-Kind <String>]
    [-StreamDeclaration <Hashtable>]
    [-Tag <Hashtable>]
    [-UserAssignedIdentity <String[]>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentityExpanded 

Update-AzDataCollectionRule
    -InputObject <IDataCollectionRuleIdentity>
    [-DataCollectionEndpointId <String>]
    [-DataFlow <IDataFlow[]>]
    [-DataSourceDataImportEventHubConsumerGroup <String>]
    [-DataSourceDataImportEventHubName <String>]
    [-DataSourceDataImportEventHubStream <String>]
    [-DataSourceExtension <IExtensionDataSource[]>]
    [-DataSourceIisLog <IIisLogsDataSource[]>]
    [-DataSourceLogFile <ILogFilesDataSource[]>]
    [-DataSourcePerformanceCounter <IPerfCounterDataSource[]>]
    [-DataSourcePlatformTelemetry <IPlatformTelemetryDataSource[]>]
    [-DataSourcePrometheusForwarder <IPrometheusForwarderDataSource[]>]
    [-DataSourceSyslog <ISyslogDataSource[]>]
    [-DataSourceWindowsEventLog <IWindowsEventLogDataSource[]>]
    [-DataSourceWindowsFirewallLog <IWindowsFirewallLogsDataSource[]>]
    [-Description <String>]
    [-DestinationAzureMonitorMetricName <String>]
    [-DestinationEventHub <IEventHubDestination[]>]
    [-DestinationEventHubsDirect <IEventHubDirectDestination[]>]
    [-DestinationLogAnalytic <ILogAnalyticsDestination[]>]
    [-DestinationMonitoringAccount <IMonitoringAccountDestination[]>]
    [-DestinationStorageAccount <IStorageBlobDestination[]>]
    [-DestinationStorageBlobsDirect <IStorageBlobDestination[]>]
    [-DestinationStorageTablesDirect <IStorageTableDestination[]>]
    [-EnableSystemAssignedIdentity <Boolean>]
    [-Kind <String>]
    [-StreamDeclaration <Hashtable>]
    [-Tag <Hashtable>]
    [-UserAssignedIdentity <String[]>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Aktualizowanie reguły zbierania danych.

Przykłady

Przykład 1. Aktualizowanie tagu dla reguły zbierania danych

$syslog = New-AzSyslogDataSourceObject -FacilityName syslog -LogLevel Alert,Critical,Emergency -Name syslogBase -Stream Microsoft-Syslog
Update-AzDataCollectionRule -Name myCollectionRule1 -ResourceGroupName Monitor-ActionGroup -DataSourceSyslog $syslog

DataCollectionEndpointId                  :
DataFlow                                  : {{
                                              "streams": [ "Microsoft-InsightsMetrics" ],
                                              "destinations": [ "azureMonitorMetrics-default" ]
                                            }}
DataSourceDataImportEventHubConsumerGroup :
DataSourceDataImportEventHubName          :
DataSourceDataImportEventHubStream        :
DataSourceExtension                       :
DataSourceIisLog                          :
DataSourceLogFile                         :
DataSourcePerformanceCounter              : {{
                                              "streams": [ "Microsoft-Perf" ],
                                              "samplingFrequencyInSeconds": 15,
                                              "counterSpecifiers": [ "\\\\Processor(_Total)\\\\% Processor Time", "\\\\Memory\\\\Committed Bytes",
                                            "\\\\LogicalDisk(_Total)\\\\Free Megabytes", "\\\\PhysicalDisk(_Total)\\\\Avg. Disk Queue Length" ],
                                              "name": "cloudTeamCoreCounters"
                                            }, {
                                              "streams": [ "Microsoft-Perf" ],
                                              "samplingFrequencyInSeconds": 30,
                                              "counterSpecifiers": [ "\\\\Process(_Total)\\\\Thread Count" ],
                                              "name": "appTeamExtraCounters"
                                            }}
DataSourcePlatformTelemetry               :
DataSourcePrometheusForwarder             :
DataSourceSyslog                          : {{
                                              "streams": [ "Microsoft-Syslog" ],
                                              "facilityNames": [ "syslog" ],
                                              "logLevels": [ "Alert", "Critical", "Emergency" ],
                                              "name": "syslogBase"
                                            }}
DataSourceWindowsEventLog                 : {{
                                              "streams": [ "Microsoft-WindowsEvent" ],
                                              "xPathQueries": [ "System![System[(Level = 1 or Level = 2 or Level = 3)]]", "Application!*[System[(Level = 1 or Level = 2
                                            or Level = 3)]]" ],
                                              "name": "appTeam1AppEvents"
                                            }}
DataSourceWindowsFirewallLog              :
Description                               :
DestinationAzureMonitorMetricName         : azureMonitorMetrics-default
DestinationEventHub                       :
DestinationEventHubsDirect                :
DestinationLogAnalytic                    :
DestinationMonitoringAccount              :
DestinationStorageAccount                 :
DestinationStorageBlobsDirect             :
DestinationStorageTablesDirect            :
Etag                                      : "9200a3d3-0000-0100-0000-654c72ae0000"
Id                                        : /subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourceGroups/Monitor-ActionGroup/providers/Microsoft.Insights/dataColle
                                            ctionRules/myCollectionRule1
IdentityPrincipalId                       :
IdentityTenantId                          :
IdentityType                              :
IdentityUserAssignedIdentity              : {
                                            }
ImmutableId                               : dcr-e30a8188813f426d962ef7053a3d1be4
Kind                                      :
Location                                  : eastus
MetadataProvisionedBy                     :
MetadataProvisionedByResourceId           :
Name                                      : myCollectionRule1
ProvisioningState                         : Succeeded
ResourceGroupName                         : Monitor-ActionGroup
StreamDeclaration                         : {
                                            }
SystemDataCreatedAt                       : 11/9/2023 5:04:01 AM
SystemDataCreatedBy                       : v-jiaji@microsoft.com
SystemDataCreatedByType                   : User
SystemDataLastModifiedAt                  : 11/9/2023 5:48:29 AM
SystemDataLastModifiedBy                  : v-jiaji@microsoft.com
SystemDataLastModifiedByType              : User
Tag                                       : {
                                            }
Type                                      : Microsoft.Insights/dataCollectionRules

To polecenie aktualizuje regułę zbierania danych.

Parametry

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataCollectionEndpointId

Identyfikator zasobu punktu końcowego zbierania danych, z którego można użyć tej reguły.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataFlow

Specyfikacja przepływów danych.

Właściwości parametrów

Typ:

IDataFlow[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataSourceDataImportEventHubConsumerGroup

Nazwa grupy odbiorców centrum zdarzeń

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataSourceDataImportEventHubName

Przyjazna nazwa źródła danych. Ta nazwa powinna być unikatowa we wszystkich źródłach danych (niezależnie od typu) w regule zbierania danych.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataSourceDataImportEventHubStream

Strumień do zbierania z usługi EventHub

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataSourceExtension

Lista konfiguracji źródła danych rozszerzenia maszyny wirtualnej platformy Azure.

Właściwości parametrów

Typ:

IExtensionDataSource[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataSourceIisLog

Lista konfiguracji źródła dzienników usług IIS.

Właściwości parametrów

Typ:

IIisLogsDataSource[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataSourceLogFile

Lista konfiguracji źródłowych plików dziennika.

Właściwości parametrów

Typ:

ILogFilesDataSource[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataSourcePerformanceCounter

Lista konfiguracji źródła danych licznika wydajności.

Właściwości parametrów

Typ:

IPerfCounterDataSource[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataSourcePlatformTelemetry

Lista konfiguracji telemetrii platformy

Właściwości parametrów

Typ:

IPlatformTelemetryDataSource[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataSourcePrometheusForwarder

Lista konfiguracji źródła danych usługi przesyłania dalej Prometheus.

Właściwości parametrów

Typ:

IPrometheusForwarderDataSource[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataSourceSyslog

Lista konfiguracji źródła danych syslog.

Właściwości parametrów

Typ:

ISyslogDataSource[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataSourceWindowsEventLog

Lista konfiguracji źródła danych dziennika zdarzeń systemu Windows.

Właściwości parametrów

Typ:

IWindowsEventLogDataSource[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DataSourceWindowsFirewallLog

Lista konfiguracji źródłowych dzienników zapory systemu Windows.

Właściwości parametrów

Typ:

IWindowsFirewallLogsDataSource[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DefaultProfile

Parametr DefaultProfile nie działa. Użyj parametru SubscriptionId, jeśli jest dostępny, jeśli wykonuje polecenie cmdlet dla innej subskrypcji.

Właściwości parametrów

Typ:PSObject
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzureRMContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Description

Opis reguły zbierania danych.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DestinationAzureMonitorMetricName

Przyjazna nazwa miejsca docelowego. Ta nazwa powinna być unikatowa we wszystkich miejscach docelowych (niezależnie od typu) w regule zbierania danych.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DestinationEventHub

Lista miejsc docelowych usługi Event Hubs.

Właściwości parametrów

Typ:

IEventHubDestination[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DestinationEventHubsDirect

Lista miejsc docelowych usługi Event Hubs Direct.

Właściwości parametrów

Typ:

IEventHubDirectDestination[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DestinationLogAnalytic

Lista miejsc docelowych usługi Log Analytics.

Właściwości parametrów

Typ:

ILogAnalyticsDestination[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DestinationMonitoringAccount

Lista miejsc docelowych kont monitorowania.

Właściwości parametrów

Typ:

IMonitoringAccountDestination[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DestinationStorageAccount

Lista miejsc docelowych kont magazynu.

Właściwości parametrów

Typ:

IStorageBlobDestination[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DestinationStorageBlobsDirect

Lista miejsc docelowych bezpośrednich obiektów blob usługi Storage. Do użycia tylko do wysyłania danych bezpośrednio do przechowywania z agenta.

Właściwości parametrów

Typ:

IStorageBlobDestination[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DestinationStorageTablesDirect

Lista miejsc docelowych bezpośrednich tabel magazynu.

Właściwości parametrów

Typ:

IStorageTableDestination[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-EnableSystemAssignedIdentity

Określa, czy włączyć tożsamość przypisaną przez system dla zasobu.

Właściwości parametrów

Typ:

Nullable<T>[Boolean]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-InputObject

Parametr tożsamości

Właściwości parametrów

Typ:IDataCollectionRuleIdentity
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateViaIdentityExpanded
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Kind

Rodzaj zasobu.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Name

Nazwa reguły zbierania danych. Nazwa jest niewrażliwa na wielkość liter.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:DataCollectionRuleName, Nazwa Reguły

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ResourceGroupName

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-StreamDeclaration

Deklaracja strumieni niestandardowych używanych w tej regule.

Właściwości parametrów

Typ:Hashtable
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-SubscriptionId

Identyfikator subskrypcji docelowej.

Właściwości parametrów

Typ:String
Wartość domyślna:(Get-AzContext).Subscription.Id
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Tag

Tagi zasobów.

Właściwości parametrów

Typ:Hashtable
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-UserAssignedIdentity

Tablica tożsamości przypisanych przez użytkownika skojarzona z zasobem. Elementy w tablicy będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

IDataCollectionRuleIdentity

Wyjść

IDataCollectionRuleResource