다음을 통해 공유

Set-AzDiagnosticSetting

  • 참조
모듈:
Az.Monitor

리소스에 대한 로그 및 메트릭 설정을 설정합니다.

구문

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

사용 설정 값에 따라 사용하거나 사용하지 않도록 설정할 로그 범주 목록을 지정합니다. 범주를 지정하지 않으면 이 명령은 지원되는 모든 범주에서 작동합니다.

형식:List<T>[String]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Enabled

진단을 사용하도록 설정할지 여부를 나타냅니다. 진단을 사용하도록 설정할 $True 지정하거나 진단을 사용하지 않도록 설정하는 $False 지정합니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-EventHubAuthorizationRuleId

이벤트 허브 권한 부여 규칙 ID

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-EventHubName

이벤트 허브 이름

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ExportToResourceSpecific

AZUREDiagnostics라는 기본 동적 스키마 테이블과 달리 LA로 내보내기를 리소스별 테이블(즉, 전용 또는 고정 스키마 테이블이라고도 함)으로 내보내야 함을 나타내는 플래그입니다.

이 인수는 -workspaceId 인수도 제공된 경우에만 유효합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-InputObject

입력 개체(파이프라인에서 가능) 이름 및 resourceId는 이 개체에서 추출됩니다.

형식:PSServiceDiagnosticSettings
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-MetricCategory

메트릭 범주 목록입니다. 범주를 지정하지 않으면 이 명령은 지원되는 모든 범주에서 작동합니다.

형식:List<T>[String]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

진단 설정의 이름입니다. 기본값은 서비스입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceId

리소스의 ID를 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-RetentionEnabled

진단 정보의 보존을 사용할 수 있는지 여부를 나타냅니다.

형식:Nullable<T>[Boolean]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-RetentionInDays

보존 정책을 일 단위로 지정합니다.

형식:Nullable<T>[Int32]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ServiceBusRuleId

Service Bus 규칙 ID입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StorageAccountId

데이터를 저장할 Storage 계정의 ID를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Timegrain

Enabled 값에 따라 메트릭을 사용하거나 사용하지 않도록 설정할 시간 범위를 지정합니다. 시간 단위를 지정하지 않으면 이 명령은 사용 가능한 모든 시간 조직에서 작동합니다.

형식:List<T>[String]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WorkspaceId

로그/메트릭을 보낼 Log Analytics 작업 영역의 리소스 ID

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

PSServiceDiagnosticSettings

String

Boolean

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]]

출력

PSServiceDiagnosticSettings