Set-AzDataFactoryV2IntegrationRuntime
統合ランタイムを更新します。
構文
Set-AzDataFactoryV2IntegrationRuntime
[-ResourceGroupName] <String>
[-DataFactoryName] <String>
[-Name] <String>
[-Type <String>]
[-Description <String>]
[-Location <String>]
[-NodeSize <String>]
[-NodeCount <Int32>]
[-CatalogServerEndpoint <String>]
[-CatalogAdminCredential <PSCredential>]
[-CatalogPricingTier <String>]
[-VNetId <String>]
[-Subnet <String>]
[-SubnetId <String>]
[-PublicIPs <String[]>]
[-DataFlowComputeType <String>]
[-DataFlowCoreCount <Int32>]
[-DataFlowTimeToLive <Int32>]
[-SetupScriptContainerSasUri <String>]
[-Edition <String>]
[-VNetInjectionMethod <String>]
[-ExpressCustomSetup <ArrayList>]
[-DataProxyIntegrationRuntimeName <String>]
[-DataProxyStagingLinkedServiceName <String>]
[-DataProxyStagingPath <String>]
[-MaxParallelExecutionsPerNode <Int32>]
[-LicenseType <String>]
[-AuthKey <SecureString>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzDataFactoryV2IntegrationRuntime
[-ResourceId] <String>
[-Type <String>]
[-Description <String>]
[-Location <String>]
[-NodeSize <String>]
[-NodeCount <Int32>]
[-CatalogServerEndpoint <String>]
[-CatalogAdminCredential <PSCredential>]
[-CatalogPricingTier <String>]
[-VNetId <String>]
[-Subnet <String>]
[-SubnetId <String>]
[-PublicIPs <String[]>]
[-DataFlowComputeType <String>]
[-DataFlowCoreCount <Int32>]
[-DataFlowTimeToLive <Int32>]
[-SetupScriptContainerSasUri <String>]
[-Edition <String>]
[-VNetInjectionMethod <String>]
[-ExpressCustomSetup <ArrayList>]
[-DataProxyIntegrationRuntimeName <String>]
[-DataProxyStagingLinkedServiceName <String>]
[-DataProxyStagingPath <String>]
[-MaxParallelExecutionsPerNode <Int32>]
[-LicenseType <String>]
[-AuthKey <SecureString>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzDataFactoryV2IntegrationRuntime
[-ResourceId] <String>
[-Type <String>]
[-Description <String>]
-SharedIntegrationRuntimeResourceId <String>
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzDataFactoryV2IntegrationRuntime
[-ResourceGroupName] <String>
[-DataFactoryName] <String>
[-Name] <String>
[-Type <String>]
[-Description <String>]
-SharedIntegrationRuntimeResourceId <String>
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzDataFactoryV2IntegrationRuntime
[-InputObject] <PSIntegrationRuntime>
[-Type <String>]
[-Description <String>]
[-Location <String>]
[-NodeSize <String>]
[-NodeCount <Int32>]
[-CatalogServerEndpoint <String>]
[-CatalogAdminCredential <PSCredential>]
[-CatalogPricingTier <String>]
[-VNetId <String>]
[-Subnet <String>]
[-SubnetId <String>]
[-PublicIPs <String[]>]
[-DataFlowComputeType <String>]
[-DataFlowCoreCount <Int32>]
[-DataFlowTimeToLive <Int32>]
[-SetupScriptContainerSasUri <String>]
[-Edition <String>]
[-VNetInjectionMethod <String>]
[-ExpressCustomSetup <ArrayList>]
[-DataProxyIntegrationRuntimeName <String>]
[-DataProxyStagingLinkedServiceName <String>]
[-DataProxyStagingPath <String>]
[-MaxParallelExecutionsPerNode <Int32>]
[-LicenseType <String>]
[-AuthKey <SecureString>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzDataFactoryV2IntegrationRuntime
[-InputObject] <PSIntegrationRuntime>
[-Type <String>]
[-Description <String>]
-SharedIntegrationRuntimeResourceId <String>
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Set-AzDataFactoryV2IntegrationRuntime コマンドレットは、特定のパラメーターを使用して統合ランタイムを更新します。
例
例 1: 統合ランタイムの説明を更新します。
Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName 'rg-test-dfv2' -DataFactoryName 'test-df-eu2' -Name 'test-selfhost-ir' `
-Description 'New description'
Id : /subscriptions/b3ee3a7f-7614-4644-ad07-afa832620b4b/resourceGroups/rg-test-dfv2/providers/Microsoft.DataFactory/factories/test-df-eu2/integrationruntimes/test-selfhost-ir
ResourceGroupName : rg-test-dfv2
DataFactoryName : test-df-eu2
Name : test-selfhost-ir
Description : New descriptionコマンドレットは、"test-selfhost-ir" という名前の統合ランタイムの説明を更新します。
例 2: セルフホステッド統合ランタイムを共有する。
Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName 'rg-test-dfv2' -DataFactoryName 'test-df-eu2' -Name 'test-selfhost-ir' `
-SharedIntegrationRuntimeResourceId '/subscriptions/b3ee3a7f-7614-4644-ad07-afa832620b4b/resourceGroups/rg-test-dfv2/providers/Microsoft.DataFactory/factories/test-df-eu2/integrationruntimes/test-selfhost-ir' -Type "SelfHosted"
Id : /subscriptions/b3ee3a7f-7614-4644-ad07-afa832620b4b/resourceGroups/rg-test-dfv2/providers/Microsoft.DataFactory/factories/test-df-eu2/integrationruntimes/test-selfhost-ir
ResourceGroupName : rg-test-dfv2
DataFactoryName : test-df-eu2
Name : test-selfhost-ir
Description : New descriptionこのコマンドレットは、共有統合ランタイムを使用する ADF を追加します。 パラメーターを使用 -SharedIntegrationRuntimeResourceId する場合は、 -Type このパラメーターも含まれている必要があります。 コマンドレットを実行する前に、統合ランタイムを使用するためのアクセス許可をデータ ファクトリに付与する必要があることに注意してください。
例 3: ADF で Azure-SSIS IR のプロキシとしてセルフホステッド IR を構成する。
Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName testgroup `
-DataFactoryName testdf `
-Name SSISIRWithDataProxy `
-DataProxyIntegrationRuntimeName proxySelfhostedIR `
-DataProxyStagingLinkedServiceName AzureBlobStorage `
-DataProxyStagingPath teststaging
Location : EastUS
NodeSize : Standard_D8_v3
NodeCount : 1
MaxParallelExecutionsPerNode : 8
CatalogServerEndpoint :
CatalogAdminUserName :
CatalogAdminPassword :
CatalogPricingTier :
VNetId :
Subnet :
SubnetId :
VNetInjectionMethod : Express
PublicIPs :
State : Initial
LicenseType : LicenseIncluded
SetupScriptContainerSasUri :
DataProxyIntegrationRuntimeName : proxySelfhostedIR
DataProxyStagingLinkedServiceName : AzureBlobStorage
DataProxyStagingPath :
Edition : Standard
Name : SSISIRWithDataProxy
Type : Managed
ResourceGroupName : testgroup
DataFactoryName : testdf
Description :
Id : /subscriptions/cb715d05-3337-4640-8c43-4f943c50d06e/resourceGroups/testgroup/providers/Microsoft.DataFactory/factories/testdf/integrationruntimes/SSISIRWithDataProxyこのコマンドレットは、セルフホステッド統合ランタイムをデータ プロキシとして使用するように Azure-SSIS 統合ランタイムを更新します。
パラメーター
-AuthKey
セルフホステッド統合ランタイムの認証キー。
| Type: | SecureString |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CatalogAdminCredential
統合ランタイムのカタログ データベース管理者の資格情報。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CatalogPricingTier
統合ランタイムのカタログ データベース価格レベル。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CatalogServerEndpoint
統合ランタイムのカタログ データベース サーバー エンドポイント。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataFactoryName
データ ファクトリ名。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DataFlowComputeType
データ フロー ジョブを実行するデータ フロー クラスターのコンピューティングの種類。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataFlowCoreCount
データ フロー ジョブを実行するデータ フロー クラスターのコア数。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataFlowEnableQuickReuse
次のデータフロー アクティビティでデータ フロー クラスターを再利用できるかどうかを指定します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataFlowTimeToLive
データ フロー ジョブを実行するデータ フロー クラスターの Time to Live (分単位) 設定。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataProxyIntegrationRuntimeName
プロキシとして使用されるセルフホステッド統合ランタイム名
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataProxyStagingLinkedServiceName
セルフホステッドと Azure-SSIS 統合ランタイムの間でデータを移動するときに使用するステージング データ ストアを参照する Azure Blob Storage のリンクされたサービス名
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataProxyStagingPath
セルフホステッドと Azure-SSIS 統合ランタイムの間でデータを移動するときに使用するステージング データ ストア内のパス。指定されていない場合は、既定のコンテナーが使用されます
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
統合ランタイムの説明。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Edition
SSIS 統合ランタイムのエディション (Standard または Enterprise の場合があります)、既定値は Standard (指定されていない場合) です。
| Type: | String |
| Accepted values: | Standard, Enterprise |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExpressCustomSetup
カスタム セットアップ スクリプトなしで構成とサード パーティ製コンポーネントをセットアップするために使用できる、SSIS 統合ランタイムの高速カスタム セットアップ。
| Type: | ArrayList |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
確認を求めずにコマンドレットを実行します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
統合ランタイム オブジェクト。
| Type: | PSIntegrationRuntime |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LicenseType
SSIS IR に対して選択するライセンスの種類。 LicenseIncluded と BasePrice の 2 種類があります。 Azure ハイブリッド使用特典 (AHUB) の価格の対象となる場合は、BasePrice を選択してください。 そうでない場合は、LicenseIncluded を選択してください。
| Type: | String |
| Accepted values: | LicenseIncluded, BasePrice |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
統合ランタイムの場所。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagedVNetCopyComputeScaleDataIntegrationUnit
コピー アクティビティの実行用に予約されている DIU 番号の設定。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagedVNetCopyComputeScaleTimeToLive
コピー アクティビティを実行する統合ランタイムの Time to Live (分単位) 設定。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagedVNetNumberOfExternalNodeCount
外部ノードの数。0 より大きく、11 未満である必要があります。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagedVNetNumberOfPipelineNodeCount
パイプライン ノードの数。0 より大きく、11 未満である必要があります。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagedVNetPipelineExternalComputeScaleTimeToLive
パイプラインと外部アクティビティを実行する統合ランタイムの有効期間 (分単位) 設定。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxParallelExecutionsPerNode
マネージド専用統合ランタイムのノードあたりの並列実行の最大数。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
統合ランタイム名。
| Type: | String |
| Aliases: | IntegrationRuntimeName |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NodeCount
統合ランタイムのターゲット ノード数。
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NodeSize
統合ランタイム ノードのサイズ。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublicIPs
統合ランタイムが使用する静的パブリック IP アドレス。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
リソース グループ名。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceId
Azure リソース ID。
| Type: | String |
| Aliases: | Id |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SelfContainedInteractiveAuthoringEnabled
セルフホステッド統合ランタイムが Azure Relay との接続を確立できない場合に、対話型の作成機能を確保する別のオプション。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SetupScriptContainerSasUri
カスタム セットアップ スクリプトを含む Azure BLOB コンテナーの SAS URI。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SharedIntegrationRuntimeResourceId
共有セルフホステッド統合ランタイムのリソース ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subnet
VNet 内のサブネットの名前。
| Type: | String |
| Aliases: | SubnetName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SubnetId
この Azure-SSIS 統合ランタイムが参加するサブネットの ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Type
統合ランタイムの種類。
| Type: | String |
| Accepted values: | Managed, SelfHosted |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VNetId
統合ランタイムが結合する VNet の ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VNetInjectionMethod
SSIS 統合ランタイムのエディション (Standard または Enterprise の場合があります)、既定値は Standard (指定されていない場合) です。
| Type: | String |
| Accepted values: | Standard, Express |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットを実行してもコマンドレットが実行されない場合の動作を示します。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
出力
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示