Add-AzLogProfile
新しいアクティビティ ログ プロファイルを作成します。 このプロファイルは、アクティビティ ログを 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 つのストレージ アカウントのみです。
- イベント ハブ - サブスクリプションごとにログ プロファイルが 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
カテゴリの一覧を指定します。
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
ログ プロファイルの場所を指定します。 有効な値: 次のコマンドレットを実行して、場所の最新の一覧を取得します。 Get-AzLocation |DisplayName の選択
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
プロファイルの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RetentionInDays
アイテム保持ポリシーを日数で指定します。 これは、指定されたストレージ アカウントにログが保持される日数です。 データを永続的に保持するには、これを 0 に設定します。 指定されていない場合、既定値は 0 になります。 通常の Standard ストレージまたはイベント ハブの課金レートは、データの保持に適用されます。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ServiceBusRuleId
Service Bus 規則の ID を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountId
ストレージ アカウントの ID を指定します。 ID は、ストレージ アカウントの完全修飾リソース ID です (例: /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
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]]
出力
関連リンク
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示