Share via

Add-AzLogProfile

  • 參考
模組:
Az.Monitor

建立新的活動記錄檔配置檔。 此配置檔可用來將活動記錄封存至 Azure 記憶體帳戶，或將它串流至相同訂用帳戶中的 Azure 事件中樞。

Syntax

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

指定類別清單。

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前先提示您確認。

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

指定記錄檔配置檔的位置。 有效值：執行下列 Cmdlet 以取得最新的位置清單。 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。 標準標準記憶體或事件中樞計費費率適用於數據保留。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceBusRuleId

指定 服務匯流排 規則的識別碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountId

指定 儲存體 帳戶的標識碼。 標識符是記憶體帳戶的完整資源標識符，例如 /subscriptions/40gpe80s-9sb7-4f07-9042-b1b6a92ja9fk/resourceGroups/activitylogRG/providers/Microsoft。儲存體/storageAccounts/activitylogstorageaccount

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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