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

Description

更新工作區。

範例

範例 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 Access Connector 資源的資源標識符。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AccessConnectorIdentityType

Access Connector 資源的識別類型。

類型:	IdentityType
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AccessConnectorUserAssignedIdentityId

與 Access Connector 資源相關聯的使用者指派身分識別的資源識別碼。類型 '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

目標訂用帳戶的標識碼。

類型:	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

語法

Description

範例

範例 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

輸入

輸出

其他資源