Set-AzureRmDataFactoryV2IntegrationRuntime
統合ランタイムを更新します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Set-AzureRmDataFactoryV2IntegrationRuntime
[-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>]
[-SetupScriptContainerSasUri <String>]
[-Edition <String>]
[-MaxParallelExecutionsPerNode <Int32>]
[-LicenseType <String>]
[-AuthKey <SecureString>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureRmDataFactoryV2IntegrationRuntime
[-ResourceId] <String>
[-Type <String>]
[-Description <String>]
[-Location <String>]
[-NodeSize <String>]
[-NodeCount <Int32>]
[-CatalogServerEndpoint <String>]
[-CatalogAdminCredential <PSCredential>]
[-CatalogPricingTier <String>]
[-VNetId <String>]
[-Subnet <String>]
[-SetupScriptContainerSasUri <String>]
[-Edition <String>]
[-MaxParallelExecutionsPerNode <Int32>]
[-LicenseType <String>]
[-AuthKey <SecureString>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureRmDataFactoryV2IntegrationRuntime
[-ResourceId] <String>
[-Type <String>]
[-Description <String>]
-SharedIntegrationRuntimeResourceId <String>
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureRmDataFactoryV2IntegrationRuntime
[-ResourceGroupName] <String>
[-DataFactoryName] <String>
[-Name] <String>
[-Type <String>]
[-Description <String>]
-SharedIntegrationRuntimeResourceId <String>
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureRmDataFactoryV2IntegrationRuntime
[-InputObject] <PSIntegrationRuntime>
[-Type <String>]
[-Description <String>]
[-Location <String>]
[-NodeSize <String>]
[-NodeCount <Int32>]
[-CatalogServerEndpoint <String>]
[-CatalogAdminCredential <PSCredential>]
[-CatalogPricingTier <String>]
[-VNetId <String>]
[-Subnet <String>]
[-SetupScriptContainerSasUri <String>]
[-Edition <String>]
[-MaxParallelExecutionsPerNode <Int32>]
[-LicenseType <String>]
[-AuthKey <SecureString>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzureRmDataFactoryV2IntegrationRuntime
[-InputObject] <PSIntegrationRuntime>
[-Type <String>]
[-Description <String>]
-SharedIntegrationRuntimeResourceId <String>
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Set-AzureRmDataFactoryV2IntegrationRuntime コマンドレットは、特定のパラメーターを使用して統合ランタイムを更新します。
例
例 1: 統合ランタイムの説明を更新します。
PS C:\> Set-AzureRmDataFactoryV2IntegrationRuntime -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: セルフホステッド統合ランタイムを共有する。
PS C:\> Set-AzureRmDataFactoryV2IntegrationRuntime -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 このパラメーターも含まれている必要があります。 コマンドレットを実行する前に、統合ランタイムを使用するためのアクセス許可をデータ ファクトリに付与する必要があることに注意してください。
パラメーター
-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 |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| Type: | IAzureContextContainer |
| Aliases: | 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 |
-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 |
-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 |
-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 |
-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 |
-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 |
-WhatIf
コマンドレットを実行してもコマンドレットが実行されない場合の動作を示します。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
Parameters: InputObject (ByValue)