Add-AzLogProfile
新しいアクティビティ ログ プロファイルを作成します。 このプロファイルは、アクティビティ ログを Azure ストレージ アカウントにアーカイブするか、同じサブスクリプション内の Azure イベント ハブにストリーミングするために使用されます。
構文
Default (既定)
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 つのストレージ アカウントのみです。
イベント ハブ - サブスクリプションごとにログ プロファイルが 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
新しいアクティビティ ログ プロファイルを作成します。 (autogenerated)
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
カテゴリの一覧を指定します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
パラメーターのプロパティ
型: IAzureContextContainer
規定値: None ワイルドカードのサポート: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-Location
ログ プロファイルの場所を指定します。
有効な値: 次のコマンドレットを実行して、場所の最新の一覧を取得します。
Get-AzLocation |DisplayName の選択
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named 必須: True パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-Name
プロファイルの名前を指定します。
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: Named 必須: True パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-RetentionInDays
アイテム保持ポリシーを日数で指定します。 これは、指定されたストレージ アカウントにログが保持される日数です。 データを永続的に保持するには、これを 0 に設定します。 指定されていない場合、既定値は 0 になります 。 通常の Standard ストレージまたはイベント ハブの課金レートは、データの保持に適用されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-ServiceBusRuleId
Service Bus 規則の ID を指定します。
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-StorageAccountId
ストレージ アカウントの ID を指定します。 ID は、ストレージ アカウントの完全修飾リソース ID です (例: /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
型: SwitchParameter
規定値: None ワイルドカードのサポート: False DontShow: False Aliases: ウィスコンシン
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParameters を参照してください。
出力
