Set-AzSqlDatabaseAudit

模組:: Az.Sql Module

變更 Azure SQL 資料庫的稽核設定。

語法

DatabaseParameterSet (預設值)

Set-AzSqlDatabaseAudit
    [-ResourceGroupName] <String>
    [-ServerName] <String>
    [-DatabaseName] <String>
    [-AuditActionGroup <AuditActionGroups[]>]
    [-AuditAction <String[]>]
    [-PredicateExpression <String>]
    [-BlobStorageTargetState <String>]
    [-StorageAccountResourceId <String>]
    [-StorageKeyType <String>]
    [-RetentionInDays <UInt32>]
    [-EventHubTargetState <String>]
    [-EventHubName <String>]
    [-EventHubAuthorizationRuleResourceId <String>]
    [-LogAnalyticsTargetState <String>]
    [-WorkspaceResourceId <String>]
    [-PassThru]
    [-UseIdentity <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DatabaseObjectParameterSet

Set-AzSqlDatabaseAudit
    -DatabaseObject <AzureSqlDatabaseModel>
    [-AuditActionGroup <AuditActionGroups[]>]
    [-AuditAction <String[]>]
    [-PredicateExpression <String>]
    [-BlobStorageTargetState <String>]
    [-StorageAccountResourceId <String>]
    [-StorageKeyType <String>]
    [-RetentionInDays <UInt32>]
    [-EventHubTargetState <String>]
    [-EventHubName <String>]
    [-EventHubAuthorizationRuleResourceId <String>]
    [-LogAnalyticsTargetState <String>]
    [-WorkspaceResourceId <String>]
    [-PassThru]
    [-UseIdentity <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Set-AzSqlDatabaseAudit Cmdlet 會變更 Azure SQL 資料庫的稽核設定。若要使用 Cmdlet，請使用 ResourceGroupName、 ServerName 和 DatabaseName 參數來識別資料庫。當 Blob 儲存體是稽核記錄的目的地時，請指定 StorageAccountResourceId 參數以判斷稽核記錄的儲存體帳戶，並指定 StorageKeyType 參數來定義儲存體金鑰。如果使用 Blob 儲存體作為目的地，您也可以設定 RetentionInDays 參數的值來定義稽核記錄的保留期，以定義稽核記錄的期間。

範例

範例 1：啟用 Azure SQL 資料庫的 Blob 儲存體稽核原則

Set-AzSqlDatabaseAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -BlobStorageTargetState Enabled  -StorageAccountResourceId "/subscriptions/7fe3301d-31d3-4668-af5e-211a890ba6e3/resourceGroups/resourcegroup01/providers/Microsoft.Storage/storageAccounts/mystorage"

範例 2：停用 Azure SQL 資料庫的 Blob 儲存體稽核原則

Set-AzSqlDatabaseAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -BlobStorageTargetState Disabled

範例 3：使用 T-SQL 述詞進行篩選，啟用 Azure SQL 資料庫的 Blob 儲存體稽核原則

Set-AzSqlDatabaseAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -PredicateExpression "schema_name <> 'sys''" -BlobStorageTargetState Enabled -StorageAccountResourceId "/subscriptions/7fe3301d-31d3-4668-af5e-211a890ba6e3/resourceGroups/resourcegroup01/providers/Microsoft.Storage/storageAccounts/mystorage"

範例 4：從 Azure SQL 資料庫的稽核原則中移除篩選

Set-AzSqlDatabaseAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -PredicateExpression ""

範例 5：啟用 Azure SQL 資料庫的事件中樞稽核原則

Set-AzSqlDatabaseAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -EventHubTargetState Enabled -EventHubName "EventHubName" -EventHubAuthorizationRuleResourceId "EventHubAuthorizationRuleResourceId"

範例 6：停用 Azure SQL 資料庫的事件中樞稽核原則

Set-AzSqlDatabaseAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -EventHubTargetState Disabled

範例 7：啟用 Azure SQL 資料庫的 Log Analytics 稽核原則

Set-AzSqlDatabaseAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -LogAnalyticsTargetState Enabled -WorkspaceResourceId "/subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2"

範例 8：停用 Azure SQL 資料庫的 Log Analytics 稽核原則

Set-AzSqlDatabaseAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -LogAnalyticsTargetState Disabled

範例 9：透過管線停用 Azure SQL 資料庫的 Log Analytics 稽核原則

Get-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" | Set-AzSqlDatabaseAudit -LogAnalyticsTargetState Disabled

範例 10：停用將 Azure SQL 資料庫的稽核記錄傳送至 Blob 儲存體，並啟用將它們傳送至 Log Analytics。

Set-AzSqlDatabaseAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -LogAnalyticsTargetState Enabled  -WorkspaceResourceId "/subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2" -BlobStorageTargetState Disabled

範例 11：啟用將 Azure SQL 資料庫的稽核記錄傳送至 Blob 儲存體、事件中樞和記錄分析。

Set-AzSqlDatabaseAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01" -BlobStorageTargetState Enabled -StorageAccountResourceId "/subscriptions/7fe3301d-31d3-4668-af5e-211a890ba6e3/resourceGroups/resourcegroup01/providers/Microsoft.Storage/storageAccounts/mystorage" -EventHubTargetState Enabled -EventHubName "EventHubName" -EventHubAuthorizationRuleResourceId "EventHubAuthorizationRuleResourceId" -LogAnalyticsTargetState Enabled  -WorkspaceResourceId "/subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2"

參數

-AuditAction

審核動作集。支援的審計動作有： SELECT UPDATE INSERT DELETE EXECUTE RECEIVE REFERENCES 定義要審核的動作的一般形式為： [action] ON [object] BY [principal] 請注意，上述格式的 [object] 可以指表、視圖或預存程序等對象，也可以指整個資料庫或模式。如果刪除並重新建立參考物件，應重新儲存稽核組態。對於後一種情況，會分別使用 DATABASE：：[dbname] 和 SCHEMA：：[schemaname] 表單。例如： SELECT on dbo.myTable by public SELECT on DATABASE：：myDatabase by public SELECT on SCHEMA：：mySchema by public 如需詳細資訊，請參閱 https://learn.microsoft.com/sql/relational-databases/security/auditing/sql-server-audit-action-groups-and-actions#database-level-audit-actions。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AuditActionGroup

建議使用的一組動作群組是下列組合 - 這會稽核針對資料庫執行的所有查詢和預存程式，以及成功和失敗的登入：

“BATCH_COMPLETED_GROUP”、“SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP”、“FAILED_DATABASE_AUTHENTICATION_GROUP” 以上組合也是預設設定的集合。這些群組涵蓋針對資料庫執行的所有 SQL 陳述式和預存程序，不應與其他群組結合使用，因為這會導致重複的稽核記錄。如需詳細資訊，請參閱https://learn.microsoft.com/sql/relational-databases/security/auditing/sql-server-audit-action-groups-and-actions#database-level-audit-action-groups。

參數屬性

類型:	AuditActionGroups[]
預設值:	None
接受的值:	BATCH_STARTED_GROUP, BATCH_COMPLETED_GROUP, APPLICATION_ROLE_CHANGE_PASSWORD_GROUP, BACKUP_RESTORE_GROUP, DATABASE_LOGOUT_GROUP, DATABASE_OBJECT_CHANGE_GROUP, DATABASE_OBJECT_OWNERSHIP_CHANGE_GROUP, DATABASE_OBJECT_PERMISSION_CHANGE_GROUP, DATABASE_OPERATION_GROUP, DATABASE_PERMISSION_CHANGE_GROUP, DATABASE_PRINCIPAL_CHANGE_GROUP, DATABASE_PRINCIPAL_IMPERSONATION_GROUP, DATABASE_ROLE_MEMBER_CHANGE_GROUP, FAILED_DATABASE_AUTHENTICATION_GROUP, SCHEMA_OBJECT_ACCESS_GROUP, SCHEMA_OBJECT_CHANGE_GROUP, SCHEMA_OBJECT_OWNERSHIP_CHANGE_GROUP, SCHEMA_OBJECT_PERMISSION_CHANGE_GROUP, SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP, USER_CHANGE_PASSWORD_GROUP, LEDGER_OPERATION_GROUP, DBCC_GROUP, DATABASE_OWNERSHIP_CHANGE_GROUP, DATABASE_CHANGE_GROUP
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BlobStorageTargetState

指出 Blob 儲存體是否為稽核記錄的目的地。

參數屬性

類型:	String
預設值:	None
接受的值:	Enabled, Disabled
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DatabaseName

SQL 資料庫名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

DatabaseParameterSet

Position:	2
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DatabaseObject

要管理其稽核原則的資料庫物件。

參數屬性

類型:	AzureSqlDatabaseModel
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

DatabaseObjectParameterSet

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EventHubAuthorizationRuleResourceId

事件中樞授權規則的資源識別碼

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EventHubName

事件中樞的名稱。如果在提供 EventHubAuthorizationRuleResourceId 時未指定任何項目，則會選取預設事件中樞。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EventHubTargetState

指出事件中樞是否為稽核記錄的目的地。

參數屬性

類型:	String
預設值:	None
接受的值:	Enabled, Disabled
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-LogAnalyticsTargetState

指出 Log Analytics 是否為稽核記錄的目的地。

參數屬性

類型:	String
預設值:	None
接受的值:	Enabled, Disabled
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PassThru

指定是否要在 Cmdlet 執行結束時輸出稽核原則

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PredicateExpression

用來篩選稽核記錄的 T-SQL 述詞（WHERE 子句）。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ResourceGroupName

資源群組的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

DatabaseParameterSet

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-RetentionInDays

稽核記錄的保留天數。僅適用於儲存體帳戶作為目的地。

參數屬性

類型:	Nullable<T>[UInt32]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ServerName

SQL Server 名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

DatabaseParameterSet

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-StorageAccountResourceId

儲存體帳戶資源識別碼

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-StorageKeyType

指定要使用的儲存存取金鑰。

參數屬性

類型:	String
預設值:	None
接受的值:	Primary, Secondary
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-UseIdentity

指出是否要使用受控識別。當您想要使用受控識別，而目標儲存體不在防火牆後方時，這是必要的。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WorkspaceResourceId

您想要傳送稽核記錄之 Log Analytics 工作區的工作區識別碼（Log Analytics 工作區的資源識別碼）。範例：/subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸出

Boolean

意見反應

此頁面對您有幫助嗎？

共用方式為

Set-AzSqlDatabaseAudit

語法

DatabaseParameterSet (預設值)

DatabaseObjectParameterSet

Description

範例

範例 1：啟用 Azure SQL 資料庫的 Blob 儲存體稽核原則

範例 2：停用 Azure SQL 資料庫的 Blob 儲存體稽核原則

範例 3：使用 T-SQL 述詞進行篩選，啟用 Azure SQL 資料庫的 Blob 儲存體稽核原則

範例 4：從 Azure SQL 資料庫的稽核原則中移除篩選

範例 5：啟用 Azure SQL 資料庫的事件中樞稽核原則

範例 6：停用 Azure SQL 資料庫的事件中樞稽核原則

範例 7：啟用 Azure SQL 資料庫的 Log Analytics 稽核原則

範例 8：停用 Azure SQL 資料庫的 Log Analytics 稽核原則

範例 9：透過管線停用 Azure SQL 資料庫的 Log Analytics 稽核原則

範例 10：停用將 Azure SQL 資料庫的稽核記錄傳送至 Blob 儲存體，並啟用將它們傳送至 Log Analytics。

範例 11：啟用將 Azure SQL 資料庫的稽核記錄傳送至 Blob 儲存體、事件中樞和記錄分析。

參數

-AuditAction

參數屬性

參數集

-AuditActionGroup

參數屬性

參數集

-BlobStorageTargetState

參數屬性

參數集

-Confirm

參數屬性

參數集

-DatabaseName

參數屬性

參數集

-DatabaseObject

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-EventHubAuthorizationRuleResourceId

參數屬性

參數集

-EventHubName

參數屬性

參數集

-EventHubTargetState

參數屬性

參數集

-LogAnalyticsTargetState

參數屬性

參數集

-PassThru

參數屬性

參數集

-PredicateExpression

參數屬性

參數集

-ResourceGroupName

參數屬性

參數集

-RetentionInDays

參數屬性

參數集

-ServerName

參數屬性

參數集

-StorageAccountResourceId

參數屬性

參數集

-StorageKeyType

參數屬性

參數集

-UseIdentity

參數屬性

參數集

-WhatIf

參數屬性

參數集

-WorkspaceResourceId