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>]
Description
Add-AzLogProfile Cmdlet 會建立記錄配置檔。
- 記憶體帳戶 - 僅支援標準儲存體帳戶(不支援進階記憶體帳戶)。 它可以是 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
新增記錄配置檔,將符合位置條件的活動記錄導出至記憶體帳戶
範例 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
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶
類型: | IAzureContextContainer |
別名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Location
指定記錄檔配置檔的位置。 有效值:執行下列 Cmdlet 以取得最新的位置清單。 Get-AzLocation |選取 DisplayName
類型: | List<T>[String] |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-Name
指定配置檔的名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-RetentionInDays
指定保留原則,以天為單位。 這是記錄在指定的記憶體帳戶中保留的天數。 若要永遠保留資料,請將此設定為 0。 如果未指定,則預設為 0。 標準標準記憶體或事件中樞計費費率適用於數據保留。
類型: | Nullable<T>[Int32] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-ServiceBusRuleId
指定服務總線規則的識別碼。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-StorageAccountId
指定記憶體帳戶的識別碼。 標識符是記憶體帳戶的完整資源標識符,例如 /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft.Storage/storageAccounts/activitylogstorageaccount
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | 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]]