Set-AzSqlServerAudit

模組:: Az.Sql Module

變更 Azure SQL Server 的稽核設定。

語法

ServerParameterSet (預設值)

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

ServerObjectParameterSet

Set-AzSqlServerAudit
    -ServerObject <AzureSqlServerModel>
    [-AuditActionGroup <AuditActionGroups[]>]
    [-PredicateExpression <String>]
    [-StorageKeyType <String>]
    [-RetentionInDays <UInt32>]
    [-BlobStorageTargetState <String>]
    [-StorageAccountResourceId <String>]
    [-EventHubTargetState <String>]
    [-EventHubName <String>]
    [-EventHubAuthorizationRuleResourceId <String>]
    [-LogAnalyticsTargetState <String>]
    [-WorkspaceResourceId <String>]
    [-PassThru]
    [-UseIdentity <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

範例

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

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

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

Set-AzSqlServerAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -BlobStorageTargetState Disabled

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

Set-AzSqlServerAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -BlobStorageTargetState Enabled -StorageAccountResourceId "/subscriptions/7fe3301d-31d3-4668-af5e-211a890ba6e3/resourceGroups/resourcegroup01/providers/Microsoft.Storage/storageAccounts/mystorage" -PredicateExpression "statement <> 'select 1'"

範例 4：從 Azure SQL Server 的稽核原則中移除篩選設定

Set-AzSqlServerAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -PredicateExpression ""

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

Set-AzSqlServerAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -EventHubTargetState Enabled -EventHubName "EventHubName" -EventHubAuthorizationRuleResourceId "EventHubAuthorizationRuleResourceId"

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

Set-AzSqlServerAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -EventHubTargetState Disabled

範例 7：啟用 Azure SQL Server 的 Log Analytics 稽核原則

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

範例 8：停用 Azure SQL Server 的 Log Analytics 稽核原則

Set-AzSqlServerAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -LogAnalyticsTargetState Disabled

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

Get-AzSqlServer -ResourceGroupName "ResourceGroup01" -ServerName "Server01" | Set-AzSqlServerAudit -LogAnalyticsTargetState Disabled

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

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

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

Set-AzSqlServerAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -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"

參數

-AsJob

在背景執行 Cmdlet

參數屬性

類型:	SwitchParameter
預設值:	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

-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

參數集

ServerParameterSet

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

參數集

ServerParameterSet

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

-ServerObject

要管理其稽核原則的伺服器物件。

參數屬性

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

參數集

ServerObjectParameterSet

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	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-AzSqlServerAudit

語法

ServerParameterSet (預設值)

ServerObjectParameterSet

Description

範例

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

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

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

範例 4：從 Azure SQL Server 的稽核原則中移除篩選設定

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

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

範例 7：啟用 Azure SQL Server 的 Log Analytics 稽核原則

範例 8：停用 Azure SQL Server 的 Log Analytics 稽核原則

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

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

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

參數

-AsJob

參數屬性

參數集

-AuditActionGroup

參數屬性

參數集

-BlobStorageTargetState

參數屬性

參數集

-Confirm

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-EventHubAuthorizationRuleResourceId

參數屬性

參數集

-EventHubName

參數屬性

參數集

-EventHubTargetState

參數屬性

參數集

-LogAnalyticsTargetState

參數屬性

參數集

-PassThru

參數屬性

參數集

-PredicateExpression

參數屬性

參數集

-ResourceGroupName

參數屬性

參數集

-RetentionInDays

參數屬性

參數集

-ServerName

參數屬性

參數集

-ServerObject

參數屬性

參數集

-StorageAccountResourceId

參數屬性

參數集

-StorageKeyType

參數屬性

參數集

-UseIdentity

參數屬性

參數集

-WhatIf

參數屬性

參數集

-WorkspaceResourceId

參數屬性

參數集

CommonParameters