Set-AzDataFactoryV2IntegrationRuntime

Reference

Modul:: Az.DataFactory

Aktualizuje prostředí Integration Runtime.

Syntaxe

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

Rutina Set-AzDataFactoryV2IntegrationRuntime aktualizuje prostředí Integration Runtime s konkrétními parametry.

Příklady

Příklad 1: Aktualizace popisu prostředí Integration Runtime

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

Rutina aktualizuje popis prostředí Integration Runtime s názvem test-selfhost-ir.

Příklad 2: Sdílení místního prostředí Integration Runtime

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

Rutina přidá ADF pro použití sdíleného prostředí Integration Runtime. Při použití parametru -SharedIntegrationRuntimeResourceId musí být zahrnut také -Type. Mějte na paměti, že datová továrna musí mít udělená oprávnění k používání prostředí Integration Runtime před spuštěním rutiny.

Příklad 3: Nakonfigurujte Self-Hosted IR jako proxy pro Azure-SSIS IR v ADF.

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

Aktualizace rutiny Azure-SSIS Integration Runtime pro použití místního prostředí Integration Runtime jako datového proxy serveru.

Parametry

-AuthKey

Ověřovací klíč místního prostředí Integration Runtime.

Typ:	SecureString
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CatalogAdminCredential

Přihlašovací údaje správce databáze katalogu prostředí Integration Runtime.

Typ:	PSCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CatalogPricingTier

Cenová úroveň databáze katalogu prostředí Integration Runtime.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CatalogServerEndpoint

Koncový bod databázového serveru katalogu prostředí Integration Runtime.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DataFactoryName

Název datové továrny.

Typ:	String
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DataFlowComputeType

Výpočetní typ clusteru toku dat, který spustí úlohu toku dat.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DataFlowCoreCount

Základní počet clusteru toku dat, který spustí úlohu toku dat.

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DataFlowEnableQuickReuse

Pokud chcete povolit opětovné použití clusteru toku dat v další aktivitě toku dat.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DataFlowTimeToLive

Nastavení času naživo (v minutách) clusteru toku dat, který spustí úlohu toku dat.

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DataProxyIntegrationRuntimeName

Název prostředí Self-Hosted Integration Runtime, který se používá jako proxy server

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DataProxyStagingLinkedServiceName

Název propojené služby Azure Blob Storage, který odkazuje na přípravné úložiště dat, které se má použít při přesouvání dat mezi Self-Hosted a Azure-SSIS Integration Runtime

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DataProxyStagingPath

Cesta v přípravném úložišti dat, které se má použít při přesouvání dat mezi Self-Hosted a Azure-SSIS Integration Runtime, použije se výchozí kontejner, pokud není zadaný.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Description

Popis prostředí Integration Runtime.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Edition

Edice prostředí SSIS Integration Runtime, která může být Standard nebo Enterprise, je ve výchozím nastavení standard, pokud není zadána.

Typ:	String
Přípustné hodnoty:	Standard, Enterprise
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ExpressCustomSetup

Expresní vlastní nastavení pro prostředí SSIS Integration Runtime, které lze použít k nastavení konfigurací a komponent třetích stran bez vlastního instalačního skriptu.

Typ:	ArrayList
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Force

Spustí rutinu bez výzvy k potvrzení.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InputObject

Objekt prostředí Integration Runtime.

Typ:	PSIntegrationRuntime
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-LicenseType

Typ licence, který chcete vybrat pro prostředí SSIS IR. Existují dva typy: LicenseIncluded nebo BasePrice. Pokud máte nárok na ceny zvýhodněného hybridního využití Azure (AHUB), vyberte BasePrice. Pokud ne, vyberte LicenseIncluded.

Typ:	String
Přípustné hodnoty:	LicenseIncluded, BasePrice
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Location

Umístění prostředí Integration Runtime.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ManagedVNetCopyComputeScaleDataIntegrationUnit

Nastavení čísla DIU vyhrazené pro provádění aktivity kopírování

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ManagedVNetCopyComputeScaleTimeToLive

Nastavení runtime integrace time to live (v minutách), které spustí aktivitu kopírování.

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ManagedVNetNumberOfExternalNodeCount

Počet externích uzlů, které by měly být větší než 0 a menší než 11.

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ManagedVNetNumberOfPipelineNodeCount

Počet uzlů kanálu, které by měly být větší než 0 a menší než 11.

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ManagedVNetPipelineExternalComputeScaleTimeToLive

Nastavení prostředí Integration Runtime (v minutách) time to live (v minutách), které spustí kanál a externí aktivitu.

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-MaxParallelExecutionsPerNode

Maximální počet paralelních spouštění na uzel pro spravovaný vyhrazený prostředí Integration Runtime

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Název prostředí Integration Runtime.

Typ:	String
Aliasy:	IntegrationRuntimeName
Position:	2
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-NodeCount

Počet cílových uzlů prostředí Integration Runtime.

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-NodeSize

Velikost uzlu prostředí Integration Runtime.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PublicIPs

Statické veřejné IP adresy, které bude prostředí Integration Runtime používat.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ResourceGroupName

Název skupiny prostředků.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ResourceId

ID prostředku Azure.

Typ:	String
Aliasy:	Id
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-SelfContainedInteractiveAuthoringEnabled

Alternativní možnost, jak zajistit interaktivní funkci vytváření, když místní prostředí Integration Runtime nemůže navázat připojení ke službě Azure Relay.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SetupScriptContainerSasUri

Identifikátor URI SAS kontejneru objektů blob Azure, který obsahuje vlastní instalační skript.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SharedIntegrationRuntimeResourceId

ID prostředku sdíleného místního prostředí Integration Runtime.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Subnet

Název podsítě ve virtuální síti

Typ:	String
Aliasy:	SubnetName
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SubnetId

ID podsítě, ke které bude tento Azure-SSIS Integration Runtime připojený.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Type

Typ prostředí Integration Runtime.

Typ:	String
Přípustné hodnoty:	Managed, SelfHosted
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-VNetId

ID virtuální sítě, ke které se prostředí Integration Runtime připojí.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-VNetInjectionMethod