다음을 통해 공유


Add-AzLogProfile

새 활동 로그 프로필을 만듭니다. 이 프로필은 활동 로그를 Azure Storage 계정에 보관하거나 동일한 구독의 Azure 이벤트 허브로 스트리밍하는 데 사용됩니다.

구문

Add-AzLogProfile
   -Name <String>
   [-StorageAccountId <String>]
   [-ServiceBusRuleId <String>]
   [-RetentionInDays <Int32>]
   -Location <System.Collections.Generic.List`1[System.String]>
   [-Category <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Add-AzLogProfile cmdlet은 로그 프로필을 만듭니다.

  • 스토리지 계정 - 표준 스토리지 계정(Premium Storage 계정은 지원되지 않음)만 지원됩니다. ARM 또는 클래식 형식일 수 있습니다. 스토리지 계정에 기록되는 경우 활동 로그 저장 비용은 일반 표준 스토리지 속도로 청구됩니다. 따라서 구독당 하나의 로그 프로필만 있을 수 있으므로 활동 로그를 내보내기 위해 구독당 하나의 스토리지 계정만 사용할 수 있습니다.
  • 이벤트 허브 - 구독당 하나의 로그 프로필만 있을 수 있으므로 활동 로그를 내보내기 위해 구독당 하나의 이벤트 허브만 사용할 수 있습니다. 활동 로그가 이벤트 허브로 스트리밍되는 경우 표준 이벤트 허브 가격 책정이 적용됩니다. 활동 로그에서 이벤트는 지역과 관련되거나 "전역"일 수 있습니다. 전역은 기본적으로 이러한 이벤트가 지역과 무관하며 지역과 독립적이라는 것을 의미합니다. 실제로 대부분의 이벤트는 이 범주에 속합니다. 활동 로그 프로필이 포털에서 설정된 경우 사용자 인터페이스에서 선택한 다른 지역과 함께 "전역"을 암시적으로 추가합니다. cmdlet을 사용하는 경우 다른 지역과 별도로 "전역"으로 위치를 명시적으로 언급해야 합니다. 참고 :- 위치에서 "전역"을 설정하지 못하면 대부분의 활동 로그가 내보내지지 않습니다. 이 cmdlet은 ShouldProcess 패턴을 구현합니다. 즉, 리소스를 실제로 만들거나 수정하거나 제거하기 전에 사용자에게 확인을 요청할 수 있습니다.

예제

예제 1: 위치 조건과 일치하는 활동 로그를 스토리지 계정으로 내보내는 새 로그 프로필 추가

Add-AzLogProfile -Location "Global","West US" -Name ExportLogProfile -StorageAccountId /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

매개 변수

-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

-Location

로그 프로필의 위치를 지정합니다. 유효한 값: 아래 cmdlet을 실행하여 최신 위치 목록을 가져옵니다. Get-AzLocation | DisplayName 선택

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

-Name

프로필의 이름을 지정합니다.

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

-RetentionInDays

보존 정책을 일 단위로 지정합니다. 지정된 스토리지 계정에서 로그가 보존되는 일 수입니다. 데이터를 영구적으로 유지하려면 이 값을 0으로 설정합니다. 지정하지 않으면 기본값은 0입니다. 일반 표준 스토리지 또는 이벤트 허브 청구 요금은 데이터 보존에 적용됩니다.

형식: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를 지정합니다. ID는 스토리지 계정의 정규화된 리소스 ID(예: /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount)입니다.

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

-WhatIf

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

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

입력

String

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

출력

PSLogProfile