Freigeben über

Set-AzDataFactoryV2IntegrationRuntime

  • Referenz
Modul:
Az.DataFactory

Aktualisiert eine Integrationslaufzeit.

Syntax

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

Beschreibung

Das Cmdlet Set-AzDataFactoryV2IntegrationRuntime aktualisiert eine Integrationslaufzeit mit bestimmten Parametern.

Beispiele

Beispiel 1: Beschreibung der Integrationslaufzeit aktualisieren.

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

Das Cmdlet aktualisiert die Beschreibung der Integrationslaufzeit mit dem Namen "test-selfhost-ir".

Beispiel 2: Freigeben der selbst gehosteten Integrationslaufzeit.

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

Das Cmdlet fügt die ADF hinzu, um die Laufzeit der gemeinsamen Integration zu verwenden. Bei Verwendung des -SharedIntegrationRuntimeResourceId Parameters muss dies -Type ebenfalls enthalten sein. Beachten Sie, dass der Data Factory die Berechtigung erteilt werden muss, die Integrationslaufzeit vor dem Ausführen des Cmdlets zu verwenden.

Beispiel 3: Konfigurieren der selbst gehosteten IR als Proxy für Azure-SSIS IR in 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

Das Cmdlet aktualisiert die Azure-SSIS-Integrationslaufzeit, um self-hosted integration runtime als Datenproxy zu verwenden.

Parameter

-AuthKey

Der Authentifizierungsschlüssel der selbst gehosteten Integrationslaufzeit.

Typ:SecureString
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CatalogAdminCredential

Die Anmeldeinformationen des Katalogdatenbankadministrators der Integrationslaufzeit.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CatalogPricingTier

Die Preisebene der Katalogdatenbank für die Integrationslaufzeit.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CatalogServerEndpoint

Der Katalogdatenbankserverendpunkt der Integrationslaufzeit.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DataFactoryName

Der Name der Datenfactory.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DataFlowComputeType

Computetyp des Datenflussclusters, der den Datenflussauftrag ausführt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DataFlowCoreCount

Kernanzahl des Datenflussclusters, der den Datenflussauftrag ausführt.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DataFlowEnableQuickReuse

So können Sie festlegen, ob der Datenflusscluster in der nächsten Datenflussaktivität wiederverwendet werden soll.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DataFlowTimeToLive

Zeit für live (in Minuten) des Datenflussclusters, der den Datenflussauftrag ausführt.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DataProxyIntegrationRuntimeName

Der Name der Self-Hosted Integration Runtime, der als Proxy verwendet wird

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DataProxyStagingLinkedServiceName

Der Name des azure Blob Storage Linked Service, der auf den Stagingdatenspeicher verweist, der beim Verschieben von Daten zwischen Self-Hosted and Azure-SSIS Integration Runtime verwendet werden soll

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DataProxyStagingPath

Der Pfad im Stagingdatenspeicher, der beim Verschieben von Daten zwischen Self-Hosted and Azure-SSIS Integration Runtimes verwendet werden soll, wird ein Standardcontainer verwendet, wenn nicht angegeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Die Beschreibung der Integrationslaufzeit.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Edition

Die Edition für die SSIS-Integrationslaufzeit, die Standard oder Enterprise sein könnte, ist Standard, wenn sie nicht angegeben ist.

Typ:String
Zulässige Werte:Standard, Enterprise
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExpressCustomSetup

Das express custom setup for SSIS integration runtime which could be used to setup configurations and 3rd party components without custom setup script.

Typ:ArrayList
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Führt das Cmdlet aus, ohne zur Bestätigung aufzufordern.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Das Integrationslaufzeitobjekt.

Typ:PSIntegrationRuntime
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LicenseType

Der Lizenztyp, den Sie für die SSIS IR auswählen möchten. Es gibt zwei Typen: LicenseIncluded oder BasePrice. Wenn Sie für die Preise von Azure Hybrid Use Benefit (AHUB) qualifiziert sind, wählen Sie "BasePrice" aus. Wenn nicht, wählen Sie "LicenseIncluded" aus.

Typ:String
Zulässige Werte:LicenseIncluded, BasePrice
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Location

Der Speicherort der Integrationslaufzeit.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ManagedVNetCopyComputeScaleDataIntegrationUnit

DIU-Nummerneinstellung, die für die Ausführung der Kopieraktivität reserviert ist.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ManagedVNetCopyComputeScaleTimeToLive

Zeit für die Live-Einstellung (in Minuten) der Integrationslaufzeit, die Kopieraktivitäten ausführt.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ManagedVNetNumberOfExternalNodeCount

Die Anzahl der externen Knoten, die größer als 0 und kleiner als 11 sein sollten.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ManagedVNetNumberOfPipelineNodeCount

Die Anzahl der Pipelineknoten, die größer als 0 und kleiner als 11 sein sollten.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ManagedVNetPipelineExternalComputeScaleTimeToLive

Zeit für live (in Minuten) Einstellung der Integrationslaufzeit, die Pipeline und externe Aktivität ausführt.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxParallelExecutionsPerNode

Maximale Anzahl paralleler Ausführung pro Knoten für eine verwaltete dedizierte Integrationslaufzeit.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Der Name der Integrationslaufzeit.

Typ:String
Aliase:IntegrationRuntimeName
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NodeCount

Die Anzahl der Zielknoten der Integrationslaufzeit.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodeSize

Die Größe der Integrations-Laufzeitknoten.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicIPs

Die statischen öffentlichen IP-Adressen, die von der Integrationslaufzeit verwendet werden.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Der Name der Ressourcengruppe.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceId

Die Azure-Ressourcen-ID.

Typ:String
Aliase:Id
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SelfContainedInteractiveAuthoringEnabled

Eine alternative Option zum Sicherstellen der interaktiven Erstellungsfunktion, wenn Ihre selbst gehostete Integrationslaufzeit keine Verbindung mit Azure Relay herstellen kann.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SetupScriptContainerSasUri

Der SAS-URI des Azure-Blobcontainers, der das benutzerdefinierte Setupskript enthält.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SharedIntegrationRuntimeResourceId

Die Ressourcen-ID der freigegebenen selbst gehosteten Integrationslaufzeit.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Subnet

Der Name des Subnetzes im VNet.

Typ:String
Aliase:SubnetName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SubnetId

Die ID des Subnetzes, zu dem diese Azure-SSIS-Integrationslaufzeit verknüpft wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Type

Der Integrationslaufzeittyp.

Typ:String
Zulässige Werte:Managed, SelfHosted
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VNetId

Die ID des VNet, dem die Integrationslaufzeit beitritt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VNetInjectionMethod

Die Edition für die SSIS-Integrationslaufzeit, die Standard oder Enterprise sein könnte, ist Standard, wenn sie nicht angegeben ist.

Typ:String
Zulässige Werte:Standard, Express
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird, aber das Cmdlet nicht ausführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

PSIntegrationRuntime

Ausgaben

PSIntegrationRuntime