Update-AzDatabricksWorkspace
構文
UpdateExpanded (既定)
Update-AzDatabricksWorkspace
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-PrepareEncryption]
[-EncryptionKeySource <String>]
[-EncryptionKeyVaultUri <String>]
[-EncryptionKeyName <String>]
[-EncryptionKeyVersion <String>]
[-KeyVaultKeyName <String>]
[-KeyVaultKeyVersion <String>]
[-KeyVaultUri <String>]
[-AmlWorkspaceId <String>]
[-SkuTier <String>]
[-Authorization <IWorkspaceProviderAuthorization[]>]
[-DefaultCatalogInitialType <String>]
[-ManagedDiskKeySource <String>]
[-ManagedDiskKeyVaultPropertiesKeyName <String>]
[-ManagedDiskKeyVaultPropertiesKeyVaultUri <String>]
[-ManagedDiskKeyVaultPropertiesKeyVersion <String>]
[-ManagedDiskRotationToLatestKeyVersionEnabled]
[-ManagedServiceKeySource <String>]
[-ManagedServicesKeyVaultPropertiesKeyName <String>]
[-ManagedServicesKeyVaultPropertiesKeyVaultUri <String>]
[-ManagedServicesKeyVaultPropertiesKeyVersion <String>]
[-UiDefinitionUri <String>]
[-Tag <Hashtable>]
[-RequiredNsgRule <String>]
[-PublicNetworkAccess <String>]
[-EnableNoPublicIP]
[-EnhancedSecurityMonitoring <String>]
[-AutomaticClusterUpdate <String>]
[-ComplianceStandard <String[]>]
[-EnhancedSecurityCompliance <String>]
[-AccessConnectorId <String>]
[-AccessConnectorIdentityType <String>]
[-AccessConnectorUserAssignedIdentityId <String>]
[-DefaultStorageFirewall <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateViaIdentityExpanded
Update-AzDatabricksWorkspace
-InputObject <IDatabricksIdentity>
[-PrepareEncryption]
[-EncryptionKeySource <String>]
[-EncryptionKeyVaultUri <String>]
[-EncryptionKeyName <String>]
[-EncryptionKeyVersion <String>]
[-KeyVaultKeyName <String>]
[-KeyVaultKeyVersion <String>]
[-KeyVaultUri <String>]
[-AmlWorkspaceId <String>]
[-SkuTier <String>]
[-Authorization <IWorkspaceProviderAuthorization[]>]
[-DefaultCatalogInitialType <String>]
[-ManagedDiskKeySource <String>]
[-ManagedDiskKeyVaultPropertiesKeyName <String>]
[-ManagedDiskKeyVaultPropertiesKeyVaultUri <String>]
[-ManagedDiskKeyVaultPropertiesKeyVersion <String>]
[-ManagedDiskRotationToLatestKeyVersionEnabled]
[-ManagedServiceKeySource <String>]
[-ManagedServicesKeyVaultPropertiesKeyName <String>]
[-ManagedServicesKeyVaultPropertiesKeyVaultUri <String>]
[-ManagedServicesKeyVaultPropertiesKeyVersion <String>]
[-UiDefinitionUri <String>]
[-Tag <Hashtable>]
[-RequiredNsgRule <String>]
[-PublicNetworkAccess <String>]
[-EnableNoPublicIP]
[-EnhancedSecurityMonitoring <String>]
[-AutomaticClusterUpdate <String>]
[-ComplianceStandard <String[]>]
[-EnhancedSecurityCompliance <String>]
[-AccessConnectorId <String>]
[-AccessConnectorIdentityType <String>]
[-AccessConnectorUserAssignedIdentityId <String>]
[-DefaultStorageFirewall <String>]
[-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 ワークスペースで暗号化を有効にするには、次の 3 つの手順を実行します。1.KeyVault で消去保護が有効になっていることを確認してください。
2.ワークスペースを -PrepareEncryption で更新します (作成されていない場合)。
3.最後の手順の出力で StorageAccountIdentityPrincipalId を見つけ、プリンシパルにキーのアクセス許可を付与します。
4.ワークスペースをもう一度更新して、暗号化キーに関する情報を入力します。
例 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 リソースのリソース ID。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-AccessConnectorIdentityType
Access Connector リソースの ID の種類。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-AccessConnectorUserAssignedIdentityId
Access Connector リソースに関連付けられているユーザー割り当て ID のリソース ID。
これは型 'UserAssigned' に必要であり、型 'SystemAssigned' には無効です。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-AmlWorkspaceId
このフィールドに使用する値。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-AsJob
コマンドをジョブとして実行する
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Authorization
ワークスペース プロバイダーの承認。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-AutomaticClusterUpdate
クラスターの自動更新機能の状態。
使用できる値: 'Enabled'、'Disabled'。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
エイリアス: AutomaticClusterUpdateValue
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ComplianceStandard
ワークスペースに関連付けられているコンプライアンス標準。
パラメーターのプロパティ
型: String [ ]
規定値: None
ワイルドカードのサポート: False
DontShow: False
エイリアス: ComplianceSecurityProfileComplianceStandard
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-DefaultCatalogInitialType
既定のカタログの初期型を定義します。
使用可能な値 (大文字と小文字を区別しない): HiveMetastore、UnityCatalog
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-DefaultProfile
Azureとの通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
型: PSObject
規定値: None
ワイルドカードのサポート: False
DontShow: False
エイリアス: AzureRMContext, AzureCredential
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-DefaultStorageFirewall
既定のストレージ ファイアウォール構成情報を取得または設定します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-EnableNoPublicIP
このフィールドに使用する値。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-EncryptionKeyName
KeyVault キーの名前。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-EncryptionKeySource
暗号化 keySource (プロバイダー)。
使用可能な値 (大文字と小文字を区別): 既定値、Microsoft.Keyvault
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-EncryptionKeyVaultUri
KeyVault の URI。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-EncryptionKeyVersion
KeyVault キーのバージョン。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-EnhancedSecurityCompliance
コンプライアンス セキュリティ プロファイル機能の状態。
使用できる値: 'Enabled'、'Disabled'。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
エイリアス: ComplianceSecurityProfileValue
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-EnhancedSecurityMonitoring
セキュリティ強化監視機能の状態。
使用できる値: 'Enabled'、'Disabled'。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
エイリアス: EnhancedSecurityMonitoringValue
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
IDENTITY パラメーター
UpdateViaIdentityExpanded
配置: Named
必須: True
パイプラインからの値: True
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-KeyVaultKeyName
KeyVault キーの名前。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-KeyVaultKeyVersion
KeyVault キーのバージョン。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-KeyVaultUri
KeyVault の URI。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ManagedDiskKeySource
暗号化 keySource (プロバイダー)。
使用可能な値 (大文字と小文字を区別): Microsoft.Keyvault
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ManagedDiskKeyVaultPropertiesKeyName
KeyVault キーの名前。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ManagedDiskKeyVaultPropertiesKeyVaultUri
KeyVault の URI。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ManagedDiskKeyVaultPropertiesKeyVersion
KeyVault キーのバージョン。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ManagedDiskRotationToLatestKeyVersionEnabled
マネージド ディスク暗号化に最新のキー バージョンを自動的に使用するかどうかを指定します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ManagedServiceKeySource
暗号化 keySource (プロバイダー)。
使用可能な値 (大文字と小文字を区別): Microsoft.Keyvault
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ManagedServicesKeyVaultPropertiesKeyName
KeyVault キーの名前。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ManagedServicesKeyVaultPropertiesKeyVaultUri
KeyVault の URI。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ManagedServicesKeyVaultPropertiesKeyVersion
KeyVault キーのバージョン。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Name
ワークスペースの名前。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
エイリアス: ワークスペース名
パラメーター セット
UpdateExpanded
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-NoWait
コマンドを非同期的に実行する
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-PrepareEncryption
暗号化用にワークスペースを準備します。
マネージド ストレージ アカウントのマネージド ID を有効にします。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-PublicNetworkAccess
ワークスペースにアクセスするためのネットワーク アクセスの種類。
プライベート リンク経由でのみワークスペースにアクセスするには、値を無効に設定します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-RequiredNsgRule
コントロール プレーン通信を制御するデータ プレーン (クラスター) がプライベート エンドポイント経由で行われるかどうかを示す値を取得または設定します。
サポートされている値は 、'AllRules' と 'NoAzureDatabricksRules' です。
'NoAzureServiceRules' 値は内部でのみ使用されます。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ResourceGroupName
リソース グループの名前。
名前は大文字と小文字を区別しません。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
UpdateExpanded
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-SkuTier
SKU 階層。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-SubscriptionId
ターゲット サブスクリプションの ID。
値は UUID である必要があります。
パラメーターのプロパティ
型: String
規定値: (Get-AzContext).Subscription.Id
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
UpdateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Tag
リソース タグ。
パラメーターのプロパティ
型: Hashtable
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-UiDefinitionUri
UI 定義ファイルが配置されている BLOB URI。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParameters を参照してください。
出力