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

Update-AzDatabricksWorkspace

参考

模块:: Az.Databricks

更新工作区。

语法

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>]

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
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AccessConnectorIdentityType

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

类型:	IdentityType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AccessConnectorUserAssignedIdentityId

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AmlWorkspaceId

应用于此字段的值。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AsJob

以作业身份运行命令

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Authorization

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

类型:	IWorkspaceProviderAuthorization[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AutomaticClusterUpdate

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

类型:	AutomaticClusterUpdateValue
别名:	AutomaticClusterUpdateValue
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ComplianceStandard

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

类型:	ComplianceStandard[]
别名:	ComplianceSecurityProfileComplianceStandard
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultCatalogInitialType

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

类型:	InitialType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

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

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultStorageFirewall

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

类型:	DefaultStorageFirewall
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableNoPublicIP

应用于此字段的值。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EncryptionKeyName

Key Vault 密钥的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EncryptionKeySource

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

类型:	KeySource
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EncryptionKeyVaultUri

Key Vault 的 URI（DNS 名称）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EncryptionKeyVersion

KeyVault 密钥的版本。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnhancedSecurityCompliance

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

类型:	ComplianceSecurityProfileValue
别名:	ComplianceSecurityProfileValue
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnhancedSecurityMonitoring

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

类型:	EnhancedSecurityMonitoringValue
别名:	EnhancedSecurityMonitoringValue
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

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

类型:	IDatabricksIdentity
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-KeyVaultKeyName

KeyVault 密钥的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-KeyVaultKeyVersion

KeyVault 密钥的版本。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-KeyVaultUri

KeyVault 的 URI。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedDiskKeySource

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

类型:	EncryptionKeySource
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedDiskKeyVaultPropertiesKeyName

KeyVault 密钥的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedDiskKeyVaultPropertiesKeyVaultUri

KeyVault 的 URI。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedDiskKeyVaultPropertiesKeyVersion

KeyVault 密钥的版本。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedDiskRotationToLatestKeyVersionEnabled

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedServiceKeySource

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

类型:	EncryptionKeySource
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedServicesKeyVaultPropertiesKeyName

KeyVault 密钥的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedServicesKeyVaultPropertiesKeyVaultUri

KeyVault 的 URI。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedServicesKeyVaultPropertiesKeyVersion

KeyVault 密钥的版本。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

工作区的名称。

类型:	String
别名:	WorkspaceName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NoWait

异步运行命令

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PrepareEncryption

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PublicNetworkAccess

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

类型:	PublicNetworkAccess
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RequiredNsgRule

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

类型:	RequiredNsgRules
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

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

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SkuTier

SKU 层。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SubscriptionId

目标订阅的 ID。

类型:	String
Position:	Named
默认值:	(Get-AzContext).Subscription.Id
必需:	False
接受管道输入:	False
接受通配符:	False

-Tag

资源标记。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UiDefinitionUri

UI 定义文件所在的 Blob URI。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

IDatabricksIdentity

输出

IWorkspace

通过

Update-AzDatabricksWorkspace

语法

说明

示例

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

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

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

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

参数

-AccessConnectorId

-AccessConnectorIdentityType

-AccessConnectorUserAssignedIdentityId

-AmlWorkspaceId

-AsJob

-Authorization

-AutomaticClusterUpdate

-ComplianceStandard

-Confirm

-DefaultCatalogInitialType

-DefaultProfile

-DefaultStorageFirewall

-EnableNoPublicIP

-EncryptionKeyName

-EncryptionKeySource

-EncryptionKeyVaultUri

-EncryptionKeyVersion

-EnhancedSecurityCompliance

-EnhancedSecurityMonitoring

-InputObject

-KeyVaultKeyName

-KeyVaultKeyVersion

-KeyVaultUri

-ManagedDiskKeySource

-ManagedDiskKeyVaultPropertiesKeyName

-ManagedDiskKeyVaultPropertiesKeyVaultUri

-ManagedDiskKeyVaultPropertiesKeyVersion

-ManagedDiskRotationToLatestKeyVersionEnabled

-ManagedServiceKeySource

-ManagedServicesKeyVaultPropertiesKeyName

-ManagedServicesKeyVaultPropertiesKeyVaultUri

-ManagedServicesKeyVaultPropertiesKeyVersion

-Name

-NoWait

-PrepareEncryption

-PublicNetworkAccess

-RequiredNsgRule

-ResourceGroupName

-SkuTier

-SubscriptionId

-Tag

-UiDefinitionUri

-WhatIf

输入

输出

其他资源