你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Update-AzDatabricksWorkspace

模块:: Az.Databricks Module

更新工作区。

语法

UpdateExpanded (默认值)

Update-AzDatabricksWorkspace
    -Name <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-PrepareEncryption]
    [-EncryptionKeySource <KeySource>]
    [-EncryptionKeyVaultUri <String>]
    [-EncryptionKeyName <String>]
    [-EncryptionKeyVersion <String>]
    [-KeyVaultKeyName <String>]
    [-KeyVaultKeyVersion <String>]
    [-KeyVaultUri <String>]
    [-AmlWorkspaceId <String>]
    [-SkuTier <String>]
    [-Authorization <IWorkspaceProviderAuthorization[]>]
    [-DefaultCatalogInitialType <InitialType>]
    [-ManagedDiskKeySource <EncryptionKeySource>]
    [-ManagedDiskKeyVaultPropertiesKeyName <String>]
    [-ManagedDiskKeyVaultPropertiesKeyVaultUri <String>]
    [-ManagedDiskKeyVaultPropertiesKeyVersion <String>]
    [-ManagedDiskRotationToLatestKeyVersionEnabled]
    [-ManagedServiceKeySource <EncryptionKeySource>]
    [-ManagedServicesKeyVaultPropertiesKeyName <String>]
    [-ManagedServicesKeyVaultPropertiesKeyVaultUri <String>]
    [-ManagedServicesKeyVaultPropertiesKeyVersion <String>]
    [-UiDefinitionUri <String>]
    [-Tag <Hashtable>]
    [-RequiredNsgRule <RequiredNsgRules>]
    [-PublicNetworkAccess <PublicNetworkAccess>]
    [-EnableNoPublicIP]
    [-EnhancedSecurityMonitoring <EnhancedSecurityMonitoringValue>]
    [-AutomaticClusterUpdate <AutomaticClusterUpdateValue>]
    [-ComplianceStandard <ComplianceStandard[]>]
    [-EnhancedSecurityCompliance <ComplianceSecurityProfileValue>]
    [-AccessConnectorId <String>]
    [-AccessConnectorIdentityType <IdentityType>]
    [-AccessConnectorUserAssignedIdentityId <String>]
    [-DefaultStorageFirewall <DefaultStorageFirewall>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentityExpanded

Update-AzDatabricksWorkspace
    -InputObject <IDatabricksIdentity>
    [-PrepareEncryption]
    [-EncryptionKeySource <KeySource>]
    [-EncryptionKeyVaultUri <String>]
    [-EncryptionKeyName <String>]
    [-EncryptionKeyVersion <String>]
    [-KeyVaultKeyName <String>]
    [-KeyVaultKeyVersion <String>]
    [-KeyVaultUri <String>]
    [-AmlWorkspaceId <String>]
    [-SkuTier <String>]
    [-Authorization <IWorkspaceProviderAuthorization[]>]
    [-DefaultCatalogInitialType <InitialType>]
    [-ManagedDiskKeySource <EncryptionKeySource>]
    [-ManagedDiskKeyVaultPropertiesKeyName <String>]
    [-ManagedDiskKeyVaultPropertiesKeyVaultUri <String>]
    [-ManagedDiskKeyVaultPropertiesKeyVersion <String>]
    [-ManagedDiskRotationToLatestKeyVersionEnabled]
    [-ManagedServiceKeySource <EncryptionKeySource>]
    [-ManagedServicesKeyVaultPropertiesKeyName <String>]
    [-ManagedServicesKeyVaultPropertiesKeyVaultUri <String>]
    [-ManagedServicesKeyVaultPropertiesKeyVersion <String>]
    [-UiDefinitionUri <String>]
    [-Tag <Hashtable>]
    [-RequiredNsgRule <RequiredNsgRules>]
    [-PublicNetworkAccess <PublicNetworkAccess>]
    [-EnableNoPublicIP]
    [-EnhancedSecurityMonitoring <EnhancedSecurityMonitoringValue>]
    [-AutomaticClusterUpdate <AutomaticClusterUpdateValue>]
    [-ComplianceStandard <ComplianceStandard[]>]
    [-EnhancedSecurityCompliance <ComplianceSecurityProfileValue>]
    [-AccessConnectorId <String>]
    [-AccessConnectorIdentityType <IdentityType>]
    [-AccessConnectorUserAssignedIdentityId <String>]
    [-DefaultStorageFirewall <DefaultStorageFirewall>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

更新工作区。

示例

示例 1：更新 Databricks 工作区的标记。

Get-AzDatabricksWorkspace -ResourceGroupName azps_test_gp_db -Name azps-databricks-workspace-t1 | Update-AzDatabricksWorkspace -Tag @{"key"="value"}

Name                         ResourceGroupName Location Managed Resource Group ID
----                         ----------------- -------- -------------------------
azps-databricks-workspace-t1 azps_test_gp_db   eastus   /subscriptions/{subId}/resourceGroups/azps_test_gp_kv_t1

此命令更新 Databricks 工作区的标记。

示例 2：在 Databricks 工作区上启用加密。

Update-AzDatabricksWorkspace -ResourceGroupName azps_test_gp_db -Name azps-databricks-workspace-t2 -PrepareEncryption
$updWsp = Get-AzDatabricksWorkspace -ResourceGroupName azps_test_gp_db -Name azps-databricks-workspace-t2
Set-AzKeyVaultAccessPolicy -VaultName azps-keyvault -ObjectId $updWsp.StorageAccountIdentityPrincipalId -PermissionsToKeys wrapkey,unwrapkey,get
Update-AzDatabricksWorkspace -ResourceGroupName azps_test_gp_db -Name azps-databricks-workspace-t2 -EncryptionKeySource 'Microsoft.KeyVault' -EncryptionKeyVaultUri https://azps-keyvault.vault.azure.net/ -EncryptionKeyName azps-k1 -EncryptionKeyVersion a563a8021cba47109d93bd6d690621a7

Name                         ResourceGroupName Location Managed Resource Group ID
----                         ----------------- -------- -------------------------
azps-databricks-workspace-t2 azps_test_gp_db   eastus   /subscriptions/{subId}/resourceGroups/azps_test_gp_kv_t2

在 Databricks 工作区上启用加密需要执行三个步骤：1.请确保 KeyVault 已启用清除保护。 2.使用 -PrepareEncryption （如果未创建工作区）更新工作区。 3.在上一步的输出中查找 StorageAccountIdentityPrincipalId 并向主体授予密钥权限。 4.再次更新工作区以填写有关加密密钥的信息：

-EncryptionKeySource
-EncryptionKeyVaultUri
-EncryptionKeyName
-EncryptionKeyVersion 5.重要！有关详细信息，请阅读以下文档中的信息： https://learn.microsoft.com/en-us/azure/databricks/security/keys/cmk-managed-services-azure/customer-managed-key-managed-services-azure?WT.mc_id=Portal-Microsoft_Azure_Databricks#--use-the-azure-portal

示例 3：在 Databricks 工作区上禁用加密。

Update-AzDatabricksWorkspace -ResourceGroupName azps_test_gp_db -Name azps-databricks-workspace-t3 -EncryptionKeySource 'Default'

Name                         ResourceGroupName Location Managed Resource Group ID
----                         ----------------- -------- -------------------------
azps-databricks-workspace-t3 azps_test_gp_db   eastus   /subscriptions/{subId}/resourceGroups/azps_test_gp_kv_t3

若要禁用加密，只需设置为 -EncryptionKeySource'Default'.

示例 4：更新 Databricks 工作区的 NsgRule。

Update-AzDatabricksWorkspace -ResourceGroupName azps_test_gp_db -Name azps-databricks-workspace-t2 -RequiredNsgRule 'AllRules'

Name                         ResourceGroupName Location Managed Resource Group ID
----                         ----------------- -------- -------------------------
azps-databricks-workspace-t2 azps_test_gp_db   eastus   /subscriptions/{subId}/resourceGroups/azps_test_gp_kv_t2

此命令更新 Databricks 工作区的 NsgRule。

参数

-AccessConnectorId

Azure Databricks 访问连接器资源的资源 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AccessConnectorIdentityType

访问连接器资源的标识类型。

参数属性

类型:	IdentityType
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AccessConnectorUserAssignedIdentityId

与访问连接器资源关联的用户分配标识的资源 ID。对于类型“UserAssigned”，对类型“SystemAssigned”无效，这是必需的。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AmlWorkspaceId

应用于此字段的值。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AsJob

以作业身份运行命令

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Authorization

工作区提供程序授权。若要构造，请参阅 AUTHORIZATION 属性的 NOTES 部分，并创建哈希表。

参数属性

类型:	IWorkspaceProviderAuthorization[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AutomaticClusterUpdate

自动群集更新功能的状态。

参数属性

类型:	AutomaticClusterUpdateValue
默认值:	None
支持通配符:	False
不显示:	False
别名:	AutomaticClusterUpdateValue

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ComplianceStandard

与工作区关联的符合性标准。

参数属性

类型:	ComplianceStandard[]
默认值:	None
支持通配符:	False
不显示:	False
别名:	ComplianceSecurityProfileComplianceStandard

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultCatalogInitialType

定义默认目录的初始类型。可能的值（不区分大小写）：HiveMetastore、UnityCatalog

参数属性

类型:	InitialType
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:	PSObject
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzureRMContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultStorageFirewall

获取或设置默认存储防火墙配置信息

参数属性

类型:	DefaultStorageFirewall
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EnableNoPublicIP

应用于此字段的值。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EncryptionKeyName

Key Vault 密钥的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EncryptionKeySource

加密密钥来源（提供程序）。可能的值（不区分大小写）：默认值，Microsoft.Keyvault

参数属性

类型:	KeySource
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EncryptionKeyVaultUri

Key Vault 的 URI（DNS 名称）。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EncryptionKeyVersion

KeyVault 密钥的版本。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EnhancedSecurityCompliance

合规性安全配置文件功能的状态。

参数属性

类型:	ComplianceSecurityProfileValue
默认值:	None
支持通配符:	False
不显示:	False
别名:	ComplianceSecurityProfileValue

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EnhancedSecurityMonitoring

增强的安全监视功能的状态。

参数属性

类型:	EnhancedSecurityMonitoringValue
默认值:	None
支持通配符:	False
不显示:	False
别名:	EnhancedSecurityMonitoringValue

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-InputObject

标识参数。若要构造，请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

参数属性

类型:	IDatabricksIdentity
默认值:	None
支持通配符:	False
不显示:	False

参数集

UpdateViaIdentityExpanded

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-KeyVaultKeyName

KeyVault 密钥的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-KeyVaultKeyVersion

KeyVault 密钥的版本。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-KeyVaultUri

KeyVault 的 URI。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagedDiskKeySource

加密密钥来源（提供程序）。可能的值（不区分大小写）：Microsoft.Keyvault

参数属性

类型:	EncryptionKeySource
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagedDiskKeyVaultPropertiesKeyName

KeyVault 密钥的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagedDiskKeyVaultPropertiesKeyVaultUri

KeyVault 的 URI。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagedDiskKeyVaultPropertiesKeyVersion

KeyVault 密钥的版本。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagedDiskRotationToLatestKeyVersionEnabled

指示是否应自动将最新的密钥版本用于托管磁盘加密。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagedServiceKeySource

加密密钥来源（提供程序）。可能的值（不区分大小写）：Microsoft.Keyvault

参数属性

类型:	EncryptionKeySource
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagedServicesKeyVaultPropertiesKeyName

KeyVault 密钥的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagedServicesKeyVaultPropertiesKeyVaultUri

KeyVault 的 URI。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManagedServicesKeyVaultPropertiesKeyVersion

KeyVault 密钥的版本。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

工作区的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	工作区名称

参数集

UpdateExpanded

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-NoWait

异步运行命令

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PrepareEncryption

准备工作区进行加密。为托管存储帐户启用托管标识。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PublicNetworkAccess

用于访问工作区的网络访问类型。将值设置为禁用，以便仅通过专用链接访问工作区。

参数属性

类型:	PublicNetworkAccess
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RequiredNsgRule

获取或设置一个值，该值指示是否通过专用终结点控制平面通信的数据平面（群集）。支持的值为“AllRules”和“NoAzureDatabricksRules”。 “NoAzureServiceRules”值仅用于内部使用。

参数属性

类型:	RequiredNsgRules
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGroupName

资源组的名称。此名称不区分大小写。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

UpdateExpanded

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SkuTier

SKU 层。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SubscriptionId

目标订阅的 ID。

参数属性

类型:	String
默认值:	(Get-AzContext).Subscription.Id
支持通配符:	False
不显示:	False

参数集

UpdateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Tag

资源标记。

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UiDefinitionUri

UI 定义文件所在的 Blob URI。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	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。