次の方法で共有

Add-AzLogProfile

  • リファレンス
モジュール:
Az.Monitor

新しいアクティビティ ログ プロファイルを作成します。 このプロファイルは、アクティビティ ログを Azure ストレージ アカウントにアーカイブするか、同じサブスクリプション内の 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>]

説明

Add-AzLogProfile コマンドレットによってログ プロファイルが作成されます。

  • ストレージ アカウント - Standard ストレージ アカウント (Premium Storage アカウントはサポートされていません) のみがサポートされます。 ARM または Classic のいずれかの型を指定できます。 ストレージ アカウントにログ記録されている場合、アクティビティ ログの保存コストは通常の Standard ストレージ レートで課金されます。 サブスクリプションごとにログ プロファイルが 1 つだけ存在する可能性があるため、アクティビティ ログのエクスポートに使用できるのは、サブスクリプションごとに 1 つのストレージ アカウントのみです。
  • Event Hub - サブスクリプションごとにログ プロファイルが 1 つだけ存在する可能性があるため、アクティビティ ログのエクスポートに使用できるのは、サブスクリプションごとに 1 つのイベント ハブのみです。 アクティビティ ログがイベント ハブにストリーミングされる場合は、標準のイベント ハブ価格が適用されます。 アクティビティ ログでは、イベントはリージョンに関連することも、"グローバル" にすることもできます。 グローバルとは、基本的に、これらのイベントはリージョンに依存せず、リージョンに依存せず、実際にはほとんどのイベントがこのカテゴリに分類されていることを意味します。 アクティビティ ログ プロファイルがポータルから設定されている場合、ユーザー インターフェイスで選択されている他のリージョンと共に "Global" が暗黙的に追加されます。 コマンドレットを使用する場合は、"Global" という場所を他のリージョンとは別に明示的に指定する必要があります。 注 :- 場所に "Global" を設定すると、アクティビティ ログの大部分がエクスポートされなくなります このコマンドレットは ShouldProcess パターンを実装します。つまり、リソースを実際に作成、変更、または削除する前に、ユーザーに確認を要求する場合があります。

例

例 1: 場所の条件に一致するアクティビティ ログをストレージ アカウントにエクスポートする新しいログ プロファイルを追加する

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

場所の条件に一致するアクティビティ ログをストレージ アカウントにエクスポートする新しいログ プロファイルを追加する

例 2

新しいアクティビティ ログ プロファイルを作成します。 (自動生成)

Add-AzLogProfile -Location 'Global' -Name ExportLogProfile -RetentionInDays <Int32> -ServiceBusRuleId <String> -StorageAccountId /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

パラメーター

-Category

カテゴリの一覧を指定します。

型:List<T>[String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Location

ログ プロファイルの場所を指定します。 有効な値: 次のコマンドレットを実行して、場所の最新の一覧を取得します。 Get-AzLocation |DisplayName の選択

型:List<T>[String]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

プロファイルの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-RetentionInDays

アイテム保持ポリシーを日数で指定します。 これは、指定されたストレージ アカウントにログが保持される日数です。 データを永続的に保持するには、これを 0 に設定。 指定されていない場合、既定値は 0 になります。 通常の Standard ストレージまたはイベント ハブの課金レートは、データの保持に適用されます。

型:Nullable<T>[Int32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ServiceBusRuleId

Service Bus 規則の ID を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-StorageAccountId

ストレージ アカウントの ID を指定します。 ID は、ストレージ アカウントの完全修飾リソース ID です (例: /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値: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