Set-AzDiagnosticSetting
리소스에 대한 로그 및 메트릭 설정을 설정합니다.
Syntax
Set-AzDiagnosticSetting
-ResourceId <String>
[-Name <String>]
[-StorageAccountId <String>]
[-ServiceBusRuleId <String>]
[-EventHubName <String>]
[-EventHubAuthorizationRuleId <String>]
[-Enabled <Boolean>]
[-Category <System.Collections.Generic.List`1[System.String]>]
[-MetricCategory <System.Collections.Generic.List`1[System.String]>]
[-Timegrain <System.Collections.Generic.List`1[System.String]>]
[-RetentionEnabled <Boolean>]
[-WorkspaceId <String>]
[-ExportToResourceSpecific]
[-RetentionInDays <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzDiagnosticSetting
-InputObject <PSServiceDiagnosticSettings>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Set-AzDiagnosticSetting cmdlet은 특정 리소스에 대한 각 시간 조직 및 로그 범주를 사용하거나 사용하지 않도록 설정합니다. 로그 및 메트릭은 지정된 스토리지 계정에 저장됩니다. 이 cmdlet은 ShouldProcess 패턴을 구현합니다. 즉, 리소스를 실제로 만들거나 수정하거나 제거하기 전에 사용자에게 확인을 요청할 수 있습니다.
예제
예제 1: 리소스에 대한 모든 메트릭 및 로그 사용
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True이 명령은 Resource01에 사용 가능한 모든 메트릭 및 로그를 사용하도록 설정합니다.
예제 2: 모든 메트릭 및 로그 사용 안 함
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $False이 명령은 Resource01 리소스에 대해 사용 가능한 모든 메트릭 및 로그를 사용하지 않도록 설정합니다.
예제 3: 여러 메트릭 범주 사용/사용 안 함
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $False -MetricCategory MetricCategory1,MetricCategory2
StorageAccountId : <storageAccountId>
StorageAccountName : <storageAccountName>
Metrics
Enabled : False
Category : MetricCategory1
Timegrain : PT1M
Enabled : False
Category : MetricCategory2
Timegrain : PT1H
Enabled : True
Category : MetricCategory3
Timegrain : PT1H
Logs
Enabled : True
Category : Category1
Enabled : True
Category : Category2
Enabled : True
Category : Category3
Enabled : False
Category : Category4이 명령은 Category1 및 Category2라는 메트릭 범주를 사용하지 않도록 설정합니다. 다른 모든 범주는 동일하게 유지합니다.
예제 4: 여러 로그 범주 사용/사용 안 함
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2
StorageAccountId : <storageAccountId>
StorageAccountName : <storageAccountName>
Metrics
Enabled : False
Category : MetricCategory1
Timegrain : PT1M
Enabled : False
Category : MetricCategory2
Timegrain : PT1H
Enabled : True
Category : MetricCategory3
Timegrain : PT1H
Logs
Enabled : True
Category : Category1
Enabled : True
Category : Category2
Enabled : True
Category : Category3
Enabled : False
Category : Category4이 명령은 Category1 및 Category2를 사용하도록 설정합니다. 다른 모든 메트릭 및 로그 범주는 동일하게 유지됩니다.
예제 4: 시간 조직 및 여러 범주 사용
PS C:\>Set-AzDiagnosticSetting -ResourceId "Resource01" -Enabled $True -Category Category1,Category2 -Timegrain PT1M이 명령은 Category1, Category2 및 시간 조직 PT1M만 사용하도록 설정합니다. 다른 모든 시간 조직 및 범주는 변경되지 않습니다.
예제 5: 파이프라인 사용
PS C:\>Get-AzDiagnosticSetting -ResourceId "Resource01" | Set-AzDiagnosticSetting -Enabled $True -Category Category1,Category2이 명령은 PowerShell 파이프라인을 사용하여 진단 설정을 설정(변경하지 않음)합니다.
매개 변수
-Category
사용 설정 값에 따라 사용하거나 사용하지 않도록 설정할 로그 범주 목록을 지정합니다. 범주를 지정하지 않으면 이 명령은 지원되는 모든 범주에서 작동합니다.
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| 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 |
-Enabled
진단을 사용하도록 설정할지 여부를 나타냅니다. 진단을 사용하도록 설정할 $True 지정하거나 진단을 사용하지 않도록 설정하는 $False 지정합니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EventHubAuthorizationRuleId
이벤트 허브 권한 부여 규칙 ID
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EventHubName
이벤트 허브 이름
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ExportToResourceSpecific
AZUREDiagnostics라는 기본 동적 스키마 테이블과 달리 LA로 내보내기를 리소스별 테이블(즉, 전용 또는 고정 스키마 테이블이라고도 함)으로 내보내야 함을 나타내는 플래그입니다.
이 인수는 -workspaceId 인수도 제공된 경우에만 유효합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InputObject
입력 개체(파이프라인에서 가능) 이름 및 resourceId는 이 개체에서 추출됩니다.
| Type: | PSServiceDiagnosticSettings |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MetricCategory
메트릭 범주 목록입니다. 범주를 지정하지 않으면 이 명령은 지원되는 모든 범주에서 작동합니다.
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
진단 설정의 이름입니다. 기본값은 서비스입니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceId
리소스의 ID를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RetentionEnabled
진단 정보의 보존을 사용할 수 있는지 여부를 나타냅니다.
| Type: | Nullable<T>[Boolean] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RetentionInDays
보존 정책을 일 단위로 지정합니다.
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ServiceBusRuleId
Service Bus 규칙 ID입니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountId
데이터를 저장할 Storage 계정의 ID를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Timegrain
Enabled 값에 따라 메트릭을 사용하거나 사용하지 않도록 설정할 시간 범위를 지정합니다. 시간 단위를 지정하지 않으면 이 명령은 사용 가능한 모든 시간 조직에서 작동합니다.
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkspaceId
로그/메트릭을 보낼 Log Analytics 작업 영역의 리소스 ID
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
입력
List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]