Update-AzDatabricksWorkspace

Referenz

Modul:: Az.Databricks

Aktualisiert einen Arbeitsbereich.

Syntax

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

Beschreibung

Aktualisiert einen Arbeitsbereich.

Beispiele

Beispiel 1: Aktualisiert die Tags eines Databricks-Arbeitsbereichs.

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

Mit diesem Befehl werden die Tags eines Databricks-Arbeitsbereichs aktualisiert.

Beispiel 2: Aktivieren der Verschlüsselung für einen Databricks-Arbeitsbereich.

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

Das Aktivieren der Verschlüsselung in einem Databricks-Arbeitsbereich führt drei Schritte aus: 1.Stellen Sie sicher, dass KeyVault den Löschschutz aktiviert hat. 2.Aktualisieren Sie den Arbeitsbereich mit -PrepareEncryption (sofern er nicht erstellt wurde). 3.Suchen Sie StorageAccountIdentityPrincipalId in der Ausgabe des letzten Schritts, und erteilen Sie dem Prinzipal Schlüsselberechtigungen. 4.Aktualisieren Sie den Arbeitsbereich erneut, um Informationen zum Verschlüsselungsschlüssel einzugeben:

-EncryptionKeySource
-EncryptionKeyVaultUri
-EncryptionKeyName
-EncryptionKeyVersion 5.Wichtig! Bitte lesen Sie die Informationen im folgenden Dokument ausführlich: 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

Beispiel 3: Deaktivieren der Verschlüsselung für einen Databricks-Arbeitsbereich.

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

Um die Verschlüsselung zu deaktivieren, legen Sie einfach -EncryptionKeySource auf 'Default'fest.

Beispiel 4: Aktualisieren von NsgRule des Databricks-Arbeitsbereichs.

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

Dieser Befehl aktualisiert NsgRule des Databricks-Arbeitsbereichs.

Parameter

-AccessConnectorId

Die Ressourcen-ID der Azure Databricks Access Connector-Ressource.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AccessConnectorIdentityType

Der Identitätstyp der Access Connector-Ressource.

Typ:	IdentityType
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AccessConnectorUserAssignedIdentityId

Die Ressourcen-ID der vom Benutzer zugewiesenen Identität, die der Access Connector-Ressource zugeordnet ist. Dies ist für den Typ 'UserAssigned' erforderlich und nicht gültig für den Typ 'SystemAssigned'.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AmlWorkspaceId

Der Wert, der für dieses Feld verwendet werden soll.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AsJob

Ausführen des Befehls als Auftrag

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Authorization

Die Autorisierungen des Arbeitsbereichsanbieters. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für AUTORISIERUNGseigenschaften, und erstellen Sie eine Hashtabelle.

Typ:	IWorkspaceProviderAuthorization[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AutomaticClusterUpdate

Status des Features für automatische Clusterupdates.

Typ:	AutomaticClusterUpdateValue
Aliase:	AutomaticClusterUpdateValue
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ComplianceStandard

Compliancestandards, die dem Arbeitsbereich zugeordnet sind.

Typ:	ComplianceStandard[]
Aliase:	ComplianceSecurityProfileComplianceStandard
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultCatalogInitialType

Definiert den ursprünglichen Typ des Standardkatalogs. Mögliche Werte (Groß-/Kleinschreibung wird nicht beachtet): HiveMetastore, UnityCatalog

Typ:	InitialType
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:	PSObject
Aliase:	AzureRMContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultStorageFirewall

Dient zum Abrufen oder Festlegen von Konfigurationsinformationen zur Standardspeicherfirewall

Typ:	DefaultStorageFirewall
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EnableNoPublicIP

Der Wert, der für dieses Feld verwendet werden soll.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EncryptionKeyName

Der Name des Schlüsseltresorschlüssels.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EncryptionKeySource

Die Verschlüsselungsschlüsselquelle (Anbieter). Mögliche Werte (Groß-/Kleinschreibung wird nicht beachtet): Default, Microsoft.Keyvault

Typ:	KeySource
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EncryptionKeyVaultUri

Der URI (DNS-Name) des Key Vault.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EncryptionKeyVersion

Die Version des KeyVault-Schlüssels.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EnhancedSecurityCompliance

Status des Compliancesicherheitsprofilfeatures.

Typ:	ComplianceSecurityProfileValue
Aliase:	ComplianceSecurityProfileValue
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EnhancedSecurityMonitoring

Status der Erweiterten Sicherheitsüberwachungsfunktion.

Typ:	EnhancedSecurityMonitoringValue
Aliase:	EnhancedSecurityMonitoringValue
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Identity-Parameter. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für INPUTOBJECT-Eigenschaften und erstellen eine Hashtabelle.

Typ:	IDatabricksIdentity
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-KeyVaultKeyName

Der Name des KeyVault-Schlüssels.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-KeyVaultKeyVersion

Die Version des KeyVault-Schlüssels.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-KeyVaultUri

Der URI von KeyVault.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ManagedDiskKeySource

Die Verschlüsselungsschlüsselquelle (Anbieter). Mögliche Werte (Groß-/Kleinschreibung wird nicht beachtet): Microsoft.Keyvault

Typ:	EncryptionKeySource
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ManagedDiskKeyVaultPropertiesKeyName

Der Name des KeyVault-Schlüssels.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ManagedDiskKeyVaultPropertiesKeyVaultUri

Der URI von KeyVault.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ManagedDiskKeyVaultPropertiesKeyVersion

Die Version des KeyVault-Schlüssels.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ManagedDiskRotationToLatestKeyVersionEnabled

Geben Sie an, ob die neueste Schlüsselversion automatisch für die Verschlüsselung verwalteter Datenträger verwendet werden soll.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ManagedServiceKeySource

Die Verschlüsselungsschlüsselquelle (Anbieter). Mögliche Werte (Groß-/Kleinschreibung wird nicht beachtet): Microsoft.Keyvault

Typ:	EncryptionKeySource
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ManagedServicesKeyVaultPropertiesKeyName

Der Name des KeyVault-Schlüssels.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ManagedServicesKeyVaultPropertiesKeyVaultUri

Der URI von KeyVault.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ManagedServicesKeyVaultPropertiesKeyVersion

Die Version des KeyVault-Schlüssels.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Name

Der Name des Arbeitsbereichs.

Typ:	String
Aliase:	WorkspaceName
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-NoWait

Asynchrones Ausführen des Befehls

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PrepareEncryption

Bereiten Sie den Arbeitsbereich für die Verschlüsselung vor. Aktiviert die verwaltete Identität für verwaltetes Speicherkonto.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PublicNetworkAccess

Der Netzwerkzugriffstyp für den Zugriff auf den Arbeitsbereich. Legen Sie den Wert auf "Deaktiviert" fest, um nur über einen privaten Link auf den Arbeitsbereich zuzugreifen.

Typ:	PublicNetworkAccess
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RequiredNsgRule

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Datenebene (Cluster) zur Steuerung der Flugzeugkommunikation über privaten Endpunkt erfolgt. Unterstützte Werte sind "AllRules" und "NoAzureDatabricksRules". Der Wert "NoAzureServiceRules" ist nur für die interne Verwendung vorgesehen.

Typ:	RequiredNsgRules
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SkuTier

Die SKU-Ebene.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SubscriptionId

Die ID des Zielabonnements.

Typ:	String
Position:	Named
Standardwert:	(Get-AzContext).Subscription.Id
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Tag

Ressourcentags.

Typ:	Hashtable
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-UiDefinitionUri

Der BLOB-URI, in dem sich die UI-Definitionsdatei befindet.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

IDatabricksIdentity

Ausgaben

IWorkspace

Freigeben über

Update-AzDatabricksWorkspace

Syntax

Beschreibung

Beispiele

Beispiel 1: Aktualisiert die Tags eines Databricks-Arbeitsbereichs.

Beispiel 2: Aktivieren der Verschlüsselung für einen Databricks-Arbeitsbereich.

Beispiel 3: Deaktivieren der Verschlüsselung für einen Databricks-Arbeitsbereich.

Beispiel 4: Aktualisieren von NsgRule des Databricks-Arbeitsbereichs.

Parameter

-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

Eingaben

Ausgaben

Zusätzliche Ressourcen