Update-AzDatabricksWorkspace

Riferimento

Modulo:: Az.Databricks

Aggiorna un'area di lavoro.

Sintassi

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

Descrizione

Aggiorna un'area di lavoro.

Esempio

Esempio 1: aggiorna i tag di un'area di lavoro di 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

Questo comando aggiorna i tag di un'area di lavoro di Databricks.

Esempio 2: Abilitare la crittografia in un'area di lavoro di 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

L'abilitazione della crittografia in un'area di lavoro di Databricks richiede tre passaggi: 1.Assicurarsi che KeyVault disponga della protezione ripulita abilitata. 2.Aggiornare l'area di lavoro con -PrepareEncryption (se non è stata creata). 3.Trovare StorageAccountIdentityPrincipalId nell'output dell'ultimo passaggio e concedere le autorizzazioni di chiave all'entità. 4.Aggiornare di nuovo l'area di lavoro per inserire informazioni sulla chiave di crittografia:

-EncryptionKeySource
-EncryptionKeyVaultUri
-EncryptionKeyName
-EncryptionKeyVersion 5.Importante! Leggere le informazioni nel documento seguente in dettaglio: 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

Esempio 3: Disabilitare la crittografia in un'area di lavoro di 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

Per disabilitare la crittografia, è sufficiente impostare -EncryptionKeySource su 'Default'.

Esempio 4: Aggiornare NsgRule dell'area di lavoro di Databricks.

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

Questo comando aggiorna NsgRule dell'area di lavoro di Databricks.

Parametri

-AccessConnectorId

ID risorsa della risorsa del connettore di accesso di Azure Databricks.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-AccessConnectorIdentityType

Tipo di identità della risorsa del connettore di accesso.

Tipo:	IdentityType
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-AccessConnectorUserAssignedIdentityId

ID risorsa dell'identità assegnata dall'utente associata alla risorsa del connettore di accesso. Questa operazione è necessaria per il tipo 'UserAssigned' e non valida per il tipo 'SystemAssigned'.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-AmlWorkspaceId

Valore che deve essere utilizzato per questo campo.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-AsJob

Eseguire il comando come processo

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Authorization

Autorizzazioni del provider dell'area di lavoro. Per costruire, vedere la sezione NOTES per le proprietà AUTHORIZATION e creare una tabella hash.

Tipo:	IWorkspaceProviderAuthorization[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-AutomaticClusterUpdate

Stato della funzionalità di aggiornamento automatico dei cluster.

Tipo:	AutomaticClusterUpdateValue
Alias:	AutomaticClusterUpdateValue
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ComplianceStandard

Standard di conformità associati all'area di lavoro.

Tipo:	ComplianceStandard[]
Alias:	ComplianceSecurityProfileComplianceStandard
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefaultCatalogInitialType

Definisce il tipo iniziale del catalogo predefinito. Valori possibili (senza distinzione tra maiuscole e minuscole): HiveMetastore, UnityCatalog

Tipo:	InitialType
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:	PSObject
Alias:	AzureRMContext, AzureCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefaultStorageFirewall

Ottiene o imposta le informazioni di configurazione del firewall di archiviazione predefinite

Tipo:	DefaultStorageFirewall
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-EnableNoPublicIP

Valore che deve essere utilizzato per questo campo.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-EncryptionKeyName

Nome della chiave di Key Vault.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-EncryptionKeySource

KeySource (provider) di crittografia. Valori possibili (senza distinzione tra maiuscole e minuscole): default, Microsoft.Keyvault

Tipo:	KeySource
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-EncryptionKeyVaultUri

URI (nome DNS) dell'insieme di credenziali delle chiavi.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-EncryptionKeyVersion

Versione della chiave keyvault.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-EnhancedSecurityCompliance

Stato della funzionalità Profilo di sicurezza della conformità.

Tipo:	ComplianceSecurityProfileValue
Alias:	ComplianceSecurityProfileValue
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-EnhancedSecurityMonitoring

Stato della funzionalità Di monitoraggio della sicurezza avanzata.

Tipo:	EnhancedSecurityMonitoringValue
Alias:	EnhancedSecurityMonitoringValue
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-InputObject

Parametro Identity. Per costruire, vedere la sezione NOTES per le proprietà INPUTOBJECT e creare una tabella hash.

Tipo:	IDatabricksIdentity
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-KeyVaultKeyName

Nome della chiave dell'insieme di credenziali delle chiavi.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-KeyVaultKeyVersion

Versione della chiave keyvault.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-KeyVaultUri

URI di KeyVault.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ManagedDiskKeySource

KeySource (provider) di crittografia. Valori possibili (senza distinzione tra maiuscole e minuscole): Microsoft.Keyvault

Tipo:	EncryptionKeySource
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ManagedDiskKeyVaultPropertiesKeyName

Nome della chiave dell'insieme di credenziali delle chiavi.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ManagedDiskKeyVaultPropertiesKeyVaultUri

URI di KeyVault.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ManagedDiskKeyVaultPropertiesKeyVersion

Versione della chiave keyvault.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ManagedDiskRotationToLatestKeyVersionEnabled

Indicare se la versione della chiave più recente deve essere usata automaticamente per Crittografia dischi gestiti.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ManagedServiceKeySource

KeySource (provider) di crittografia. Valori possibili (senza distinzione tra maiuscole e minuscole): Microsoft.Keyvault

Tipo:	EncryptionKeySource
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ManagedServicesKeyVaultPropertiesKeyName

Nome della chiave dell'insieme di credenziali delle chiavi.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ManagedServicesKeyVaultPropertiesKeyVaultUri

URI di KeyVault.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ManagedServicesKeyVaultPropertiesKeyVersion

Versione della chiave keyvault.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Name

Nome dell'area di lavoro.

Tipo:	String
Alias:	WorkspaceName
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-NoWait

Eseguire il comando in modo asincrono

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PrepareEncryption

Preparare l'area di lavoro per la crittografia. Abilita l'identità gestita per l'account di archiviazione gestito.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PublicNetworkAccess

Tipo di accesso alla rete per l'accesso all'area di lavoro. Impostare il valore su disabilitato per accedere all'area di lavoro solo tramite collegamento privato.

Tipo:	PublicNetworkAccess
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RequiredNsgRule

Ottiene o imposta un valore che indica se il piano dati (cluster) per controllare la comunicazione del piano avviene tramite endpoint privato. I valori supportati sono 'AllRules' e 'NoAzureDatabricksRules'. Il valore 'NoAzureServiceRules' è solo per uso interno.

Tipo:	RequiredNsgRules
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ResourceGroupName

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SkuTier

Livello SKU.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SubscriptionId

ID della sottoscrizione di destinazione.

Tipo:	String
Posizione:	Named
Valore predefinito:	(Get-AzContext).Subscription.Id
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Tag

Tag di risorsa.

Tipo:	Hashtable
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-UiDefinitionUri

URI BLOB in cui si trova il file di definizione dell'interfaccia utente.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

IDatabricksIdentity

Output

IWorkspace

Condividi tramite

Update-AzDatabricksWorkspace

Sintassi

Descrizione

Esempio

Esempio 1: aggiorna i tag di un'area di lavoro di Databricks.

Esempio 2: Abilitare la crittografia in un'area di lavoro di Databricks.

Esempio 3: Disabilitare la crittografia in un'area di lavoro di Databricks.

Esempio 4: Aggiornare NsgRule dell'area di lavoro di Databricks.

Parametri

-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

Input

Output

Risorse aggiuntive