다음을 통해 공유

Set-AzDiagnosticSetting

모듈:
Az.Monitor Module

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

구문

OldSetDiagnosticSetting (기본값) 

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

NewSetDiagnosticSetting 

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]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Confirm

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DefaultProfile

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

매개 변수 속성

형식:IAzureContextContainer
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AzContext, AzureRmContext, AzureCredential

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Enabled

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

매개 변수 속성

형식:Boolean
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-EventHubAuthorizationRuleId

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-EventHubName

이벤트 허브 이름

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-ExportToResourceSpecific

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

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-InputObject

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

매개 변수 속성

형식:PSServiceDiagnosticSettings
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

NewSetDiagnosticSetting
Position:Named
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-MetricCategory

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

매개 변수 속성

형식:

List<T>[String]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Name

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-ResourceId

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-RetentionEnabled

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

매개 변수 속성

형식:

Nullable<T>[Boolean]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-RetentionInDays

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

매개 변수 속성

형식:

Nullable<T>[Int32]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-ServiceBusRuleId

Service Bus 규칙 ID입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-StorageAccountId

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Timegrain

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

매개 변수 속성

형식:

List<T>[String]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WorkspaceId

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OldSetDiagnosticSetting
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

PSServiceDiagnosticSettings

String

Boolean

List<T>

Nullable<T>

Nullable<T>

출력

PSServiceDiagnosticSettings