你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Set-AzDataFactoryV2IntegrationRuntime

模块:

Az.DataFactory

更新集成运行时。

语法

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>]
   [-DataFlowEnableQuickReuse]
   [-DataFlowCoreCount <Int32>]
   [-DataFlowTimeToLive <Int32>]
   [-ManagedVNetCopyComputeScaleDataIntegrationUnit <Int32>]
   [-ManagedVNetCopyComputeScaleTimeToLive <Int32>]
   [-ManagedVNetPipelineExternalComputeScaleTimeToLive <Int32>]
   [-ManagedVNetNumberOfPipelineNodeCount <Int32>]
   [-ManagedVNetNumberOfExternalNodeCount <Int32>]
   [-SelfContainedInteractiveAuthoringEnabled]
   [-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>]
   [-DataFlowEnableQuickReuse]
   [-DataFlowCoreCount <Int32>]
   [-DataFlowTimeToLive <Int32>]
   [-ManagedVNetCopyComputeScaleDataIntegrationUnit <Int32>]
   [-ManagedVNetCopyComputeScaleTimeToLive <Int32>]
   [-ManagedVNetPipelineExternalComputeScaleTimeToLive <Int32>]
   [-ManagedVNetNumberOfPipelineNodeCount <Int32>]
   [-ManagedVNetNumberOfExternalNodeCount <Int32>]
   [-SelfContainedInteractiveAuthoringEnabled]
   [-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>]
   [-DataFlowEnableQuickReuse]
   [-DataFlowCoreCount <Int32>]
   [-DataFlowTimeToLive <Int32>]
   [-ManagedVNetCopyComputeScaleDataIntegrationUnit <Int32>]
   [-ManagedVNetCopyComputeScaleTimeToLive <Int32>]
   [-ManagedVNetPipelineExternalComputeScaleTimeToLive <Int32>]
   [-ManagedVNetNumberOfPipelineNodeCount <Int32>]
   [-ManagedVNetNumberOfExternalNodeCount <Int32>]
   [-SelfContainedInteractiveAuthoringEnabled]
   [-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 cmdlet 使用特定参数更新集成运行时。

示例

示例 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

该 cmdlet 更新名为“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

该 cmdlet 添加 ADF 以使用共享集成运行时。 使用 -SharedIntegrationRuntimeResourceId 参数时，还必须包含 -Type。 请注意，在运行 cmdlet 之前，需要向数据工厂授予使用集成运行时的权限。

示例 3：将 Self-Hosted IR 配置为 ADF 中 Azure-SSIS 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

cmdlet 更新 Azure-SSIS 集成运行时，以使用自承载集成运行时作为数据代理。

参数

-AuthKey

自承载集成运行时的身份验证密钥。

类型:	SecureString
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CatalogAdminCredential

集成运行时的目录数据库管理员凭据。

类型:	PSCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CatalogPricingTier

集成运行时的目录数据库定价层。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CatalogServerEndpoint

集成运行时的目录数据库服务器终结点。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DataFactoryName

数据工厂名称。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-DataFlowComputeType

将执行数据流作业的数据流群集的计算类型。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DataFlowCoreCount

将执行数据流作业的数据流群集的核心计数。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DataFlowEnableQuickReuse

若要使数据流群集能够在下一个数据流活动中重复使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DataFlowTimeToLive

数据流群集的生存时间（以分钟为单位）设置，该群集将执行数据流作业。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DataProxyIntegrationRuntimeName

用作代理的 Self-Hosted Integration Runtime 名称

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DataProxyStagingLinkedServiceName

Azure Blob 存储链接服务名称，该名称引用在 Self-Hosted 和 Azure-SSIS Integration Runtime 之间移动数据时要使用的暂存数据存储

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DataProxyStagingPath

在 Self-Hosted 和 Azure-SSIS Integration Runtime 之间移动数据时要使用的暂存数据存储中的路径，如果未指定，将使用默认容器

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Description

集成运行时说明。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Edition

SSIS 集成运行时（可以是标准或企业版）的版本，如果未指定，则默认值为 Standard。

类型:	String
接受的值:	Standard, Enterprise
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ExpressCustomSetup

SSIS 集成运行时的快速自定义设置，可用于在没有自定义安装脚本的情况下设置配置和第三方组件。

类型:	ArrayList
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

在不提示确认的情况下运行 cmdlet。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

集成运行时对象。

类型:	PSIntegrationRuntime
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-LicenseType

要为 SSIS IR 选择的许可证类型。 有两种类型：LicenseIncluded 或 BasePrice。 如果有资格获得 Azure 混合使用权益（AHUB）定价，请选择 BasePrice。 如果没有，请选择 LicenseIncluded。

类型:	String
接受的值:	LicenseIncluded, BasePrice
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Location

集成运行时位置。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedVNetCopyComputeScaleDataIntegrationUnit

为复制活动执行保留的 DIU 编号设置。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedVNetCopyComputeScaleTimeToLive

集成运行时的生存时间（以分钟为单位），该设置将执行复制活动。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedVNetNumberOfExternalNodeCount

外部节点的数目，应大于 0 且小于 11。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedVNetNumberOfPipelineNodeCount

管道节点的数目，应大于 0 且小于 11。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedVNetPipelineExternalComputeScaleTimeToLive

集成运行时的生存时间（以分钟为单位），该设置将执行管道和外部活动。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MaxParallelExecutionsPerNode

托管专用集成运行时每个节点的最大并行执行计数。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

集成运行时名称。

类型:	String
别名:	IntegrationRuntimeName
Position:	2
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-NodeCount

集成运行时的目标节点计数。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NodeSize

集成运行时节点大小。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PublicIPs

集成运行时将使用的静态公共 IP 地址。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

资源组名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ResourceId

Azure 资源 ID。

类型:	String
别名:	Id
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-SelfContainedInteractiveAuthoringEnabled

当自承载集成运行时无法与 Azure 中继建立连接时，确保交互式创作函数的替代选项。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SetupScriptContainerSasUri

包含自定义安装脚本的 Azure Blob 容器的 SAS URI。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SharedIntegrationRuntimeResourceId

共享自承载集成运行时的资源 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Subnet

VNet 中子网的名称。

类型:	String
别名:	SubnetName
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SubnetId

要加入此 Azure-SSIS 集成运行时的子网 ID。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Type

集成运行时类型。

类型:	String
接受的值:	Managed, SelfHosted
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VNetId

集成运行时加入的 VNet 的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VNetInjectionMethod

SSIS 集成运行时（可以是标准或企业版）的版本，如果未指定，则默认值为 Standard。

类型:	String
接受的值:	Standard, Express
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行但未运行 cmdlet 时会发生什么情况。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

String

PSIntegrationRuntime

输出

PSIntegrationRuntime