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

Description

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: ADF에서 Azure-SSIS IR에 대한 프록시로 Self-Hosted 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
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CatalogAdminCredential

통합 런타임의 카탈로그 데이터베이스 관리자 자격 증명입니다.

형식:	PSCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CatalogPricingTier

통합 런타임의 카탈로그 데이터베이스 가격 책정 계층입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CatalogServerEndpoint

통합 런타임의 카탈로그 데이터베이스 서버 엔드포인트입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DataFactoryName

데이터 팩터리 이름입니다.

형식:	String
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-DataFlowComputeType

데이터 흐름 작업을 실행할 데이터 흐름 클러스터의 컴퓨팅 형식입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DataFlowCoreCount

데이터 흐름 작업을 실행할 데이터 흐름 클러스터의 코어 수입니다.

형식:	Nullable<T>[Int32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DataFlowEnableQuickReuse

다음 데이터 흐름 작업에서 데이터 흐름 클러스터를 다시 사용할 수 있도록 설정할지 여부를 나타냅니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DataFlowTimeToLive

데이터 흐름 작업을 실행할 데이터 흐름 클러스터의 TL(Time to Live) 설정(분)입니다.

형식:	Nullable<T>[Int32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DataProxyIntegrationRuntimeName

프록시로 사용되는 Self-Hosted Integration Runtime 이름

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DataProxyStagingLinkedServiceName

Self-Hosted 및 Azure-SSIS Integration Runtime 간에 데이터를 이동할 때 사용할 준비 데이터 저장소를 참조하는 Azure Blob Storage 연결된 서비스 이름

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DataProxyStagingPath

Self-Hosted 및 Azure-SSIS Integration Runtime 간에 데이터를 이동할 때 사용할 스테이징 데이터 저장소의 경로이며, 지정되지 않은 경우 기본 컨테이너가 사용됩니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:	IAzureContextContainer
별칭:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Description

통합 런타임 설명입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Edition

표준 또는 엔터프라이즈일 수 있는 SSIS 통합 런타임용 버전이며, 지정하지 않은 경우 기본값은 Standard입니다.

형식:	String
허용되는 값:	Standard, Enterprise
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ExpressCustomSetup

사용자 지정 설정 스크립트 없이 구성 및 타사 구성 요소를 설정하는 데 사용할 수 있는 SSIS 통합 런타임에 대한 빠른 사용자 지정 설정입니다.

형식:	ArrayList
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Force

확인 메시지를 표시하지 않고 cmdlet을 실행합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-InputObject

통합 런타임 개체입니다.

형식:	PSIntegrationRuntime
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-LicenseType

SSIS IR에 대해 선택할 라이선스 유형입니다. LicenseIncluded 또는 BasePrice의 두 가지 유형이 있습니다. Azure AHUB(하이브리드 사용 혜택) 가격 책정에 대한 자격이 있는 경우 BasePrice를 선택하세요. 그렇지 않은 경우 LicenseIncluded를 선택하세요.

형식:	String
허용되는 값:	LicenseIncluded, BasePrice
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Location

통합 런타임 위치입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ManagedVNetCopyComputeScaleDataIntegrationUnit

복사 작업 실행을 위해 예약된 DIU 번호 설정입니다.

형식:	Nullable<T>[Int32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ManagedVNetCopyComputeScaleTimeToLive

복사 작업을 실행할 통합 런타임의 TL(Time to Live) 설정(분)입니다.

형식:	Nullable<T>[Int32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ManagedVNetNumberOfExternalNodeCount

0보다 크고 11보다 작은 외부 노드의 수입니다.

형식:	Nullable<T>[Int32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ManagedVNetNumberOfPipelineNodeCount

0보다 크고 11보다 작아야 하는 파이프라인 노드의 수입니다.

형식:	Nullable<T>[Int32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ManagedVNetPipelineExternalComputeScaleTimeToLive

파이프라인 및 외부 작업을 실행하는 통합 런타임의 TL(Time to Live) 설정(분)입니다.

형식:	Nullable<T>[Int32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MaxParallelExecutionsPerNode

관리되는 전용 통합 런타임에 대한 노드당 최대 병렬 실행 수입니다.

형식:	Nullable<T>[Int32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Name

통합 런타임 이름입니다.

형식:	String
별칭:	IntegrationRuntimeName
Position:	2
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-NodeCount

통합 런타임의 대상 노드 수입니다.

형식:	Nullable<T>[Int32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NodeSize

통합 런타임 노드 크기입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PublicIPs

통합 런타임에서 사용할 고정 공용 IP 주소입니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ResourceGroupName

리소스 그룹 이름입니다.

형식:	String
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ResourceId

Azure 리소스 ID입니다.

형식:	String
별칭:	Id
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-SelfContainedInteractiveAuthoringEnabled

자체 호스팅 통합 런타임이 Azure Relay와의 연결을 설정할 수 없는 경우 대화형 제작 기능을 보장하는 대체 옵션입니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SetupScriptContainerSasUri

사용자 지정 설치 스크립트를 포함하는 Azure Blob 컨테이너의 SAS URI입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SharedIntegrationRuntimeResourceId

공유 자체 호스팅 통합 런타임의 리소스 ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Subnet

VNet의 서브넷 이름입니다.

형식:	String
별칭:	SubnetName
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SubnetId

이 Azure-SSIS 통합 런타임이 조인될 서브넷의 ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Type

통합 런타임 형식입니다.

형식:	String
허용되는 값:	Managed, SelfHosted
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-VNetId

통합 런타임이 조인하는 VNet의 ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-VNetInjectionMethod