Anpassen des Setups für eine Azure-SSIS Integration RuntimeCustomize the setup for an Azure-SSIS Integration Runtime

GILT FÜR: JaAzure Data Factory NeinAzure Synapse Analytics (Vorschau) APPLIES TO: yesAzure Data Factory yesAzure Synapse Analytics (Preview)

Das benutzerdefinierte Setup für eine Azure-SQL Server Integration Services Integration Runtime (Azure-SSIS IR) bietet eine Schnittstelle zum Hinzufügen Ihrer eigenen Schritte während der Einrichtung oder Neukonfiguration Ihrer Azure-SSIS IR.The custom setup for an Azure-SQL Server Integration Services Integration Runtime (Azure-SSIS IR) provides an interface for adding your own steps during the setup or reconfiguration of your Azure-SSIS IR.

Mithilfe des benutzerdefinierten Setups können Sie die Standardkonfiguration des Betriebssystems oder der Umgebung ändern, um beispielsweise zusätzliche Windows-Dienste zu starten, die Zugriffsanmeldeinformationen für Dateifreigaben beizubehalten oder eine starke Kryptografie/ein sichereres Netzwerkprotokoll (TLS 1.2) zu verwenden.By using the custom setup, you can alter the default operating configuration or environment to, for example, start additional Windows services, persist access credentials for file shares, or use strong cryptography/more secure network protocol (TLS 1.2). Oder Sie können zusätzliche Komponenten, z. B. Assemblys, Treiber oder Erweiterungen, auf jedem Knoten ihrer Azure-SSIS IR installieren.Or you can install additional components, such as assemblies, drivers, or extensions, on each node of your Azure-SSIS IR.

Es gibt zwei Möglichkeiten zur Durchführung benutzerdefinierter Setups auf Ihrer Azure-SSIS IR:You can do custom setups on your Azure-SSIS IR in either of two ways:

  • Benutzerdefiniertes Express-Setup ohne ein Skript: Führen Sie einige gängige Systemkonfigurationen und Windows-Befehle aus, oder installieren Sie einige beliebte oder empfohlene zusätzliche Komponenten, ohne Skripts zu verwenden.Express custom setup without a script: Run some common system configurations and Windows commands or install some popular or recommended additional components without using any scripts.
  • Benutzerdefiniertes Standard-Setup mit einem Skript: Bereiten Sie ein Skript und die zugehörigen Dateien vor, und laden Sie alle zusammen in einen Blobcontainer in Ihrem Azure Storage-Konto hoch.Standard custom setup with a script: Prepare a script and its associated files, and upload them all together to a blob container in your Azure storage account. Sie müssen dann einen SAS-URI (Shared Access Signature-Uniform Resource Identifier) für Ihren Container bereitstellen, wenn Sie Azure-SSIS IR einrichten oder neu konfigurieren.You then provide a Shared Access Signature (SAS) Uniform Resource Identifier (URI) for your container when you set up or reconfigure your Azure-SSIS IR. Anschließend lädt jeder Knoten Ihrer Azure-SSIS IR das Skript und die zugehörigen Dateien aus Ihrem Container herunter und führt Ihr benutzerdefiniertes Setup mit erhöhten Berechtigungen aus.Each node of your Azure-SSIS IR then downloads the script and its associated files from your container and runs your custom setup with elevated permissions. Wenn Ihr benutzerdefiniertes Setup abgeschlossen ist, lädt jeder Knoten die standardmäßige Ausgabe der Ausführung und andere Protokolle in den Container hoch.When your custom setup is finished, each node uploads the standard output of execution and other logs to your container.

Sie können sowohl kostenlose, nicht lizenzierte als auch kostenpflichtige, lizenzierte Komponenten mit benutzerdefinierten Express- und Standard-Setups installieren.You can install both free, unlicensed components and paid, licensed components with express and standard custom setups. Wenn Sie ein unabhängiger Softwareanbieter (Independent Software Vendor, ISV) sind, finden Sie weitere Informationen unter Entwickeln kostenpflichtiger oder lizenzierter Komponenten für eine Azure-SSIS IR.If you're an independent software vendor (ISV), see Develop paid or licensed components for an Azure-SSIS IR.

Wichtig

Um von zukünftigen Verbesserungen zu profitieren, empfehlen wir die Verwendung von mindestens V3 für Ihre Azure-SSIS IR mit benutzerdefiniertem Setup.To benefit from future enhancements, we recommend using v3 or later series of nodes for your Azure-SSIS IR with custom setup.

Aktuelle EinschränkungenCurrent limitations

Die folgenden Einschränkungen gelten nur für benutzerdefinierte Standard-Setups:The following limitations apply only to standard custom setups:

  • Wenn Sie gacutil.exe in Ihrem Skript verwenden möchten, um Assemblys im globalen Assemblycache (GAC) zu installieren, müssen Sie gacutil.exe als Teil Ihres benutzerdefinierten Setups bereitstellen.If you want to use gacutil.exe in your script to install assemblies in the global assembly cache (GAC), you need to provide gacutil.exe as part of your custom setup. Oder Sie können die Kopie verwenden, die in unserem Container Öffentliche Vorschau bereitgestellt wird. Dies wird weiter unten im Abschnitt „Anweisungen“ erläutert.Or you can use the copy that's provided in our Public Preview container, discussed later in the "Instructions" section.

  • Wenn Sie in Ihrem Skript auf einen Unterordner verweisen möchten, unterstützt msiexec.exe nicht die .\-Notation zum Verweisen auf den Stammordner.If you want to reference a subfolder in your script, msiexec.exe doesn't support the .\ notation to reference the root folder. Verwenden Sie einen Befehl, z. B. msiexec /i "MySubfolder\MyInstallerx64.msi" ..., anstelle von msiexec /i ".\MySubfolder\MyInstallerx64.msi" ....Use a command such as msiexec /i "MySubfolder\MyInstallerx64.msi" ... instead of msiexec /i ".\MySubfolder\MyInstallerx64.msi" ....

  • Administrative Freigaben oder verborgene Netzwerkfreigaben, die von Windows automatisch erstellt werden, werden in der Azure-SSIS IR derzeit nicht unterstützt.Administrative shares, or hidden network shares that are automatically created by Windows, are currently not supported on the Azure-SSIS IR.

  • Der ODBC-Treiber „IBM iSeries Access“ wird in der Azure-SSIS IR nicht unterstützt.The IBM iSeries Access ODBC driver is not supported on the Azure-SSIS IR. Während Ihres benutzerdefinierten Setups werden möglicherweise Installationsfehler angezeigt.You might see installation errors during your custom setup. Sollte dies der Fall sein, wenden Sie sich an den IBM-Kundendienst.If you do, contact IBM support for assistance.

VoraussetzungenPrerequisites

Hinweis

Dieser Artikel wurde aktualisiert und beinhaltet jetzt das neue Az-Modul von Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Sie können das AzureRM-Modul weiterhin verwenden, das bis mindestens Dezember 2020 weiterhin Fehlerbehebungen erhält.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Weitere Informationen zum neuen Az-Modul und zur Kompatibilität mit AzureRM finden Sie unter Introducing the new Azure PowerShell Az module (Einführung in das neue Az-Modul von Azure PowerShell).To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Anweisungen zur Installation des Az-Moduls finden Sie unter Install Azure PowerShell (Installieren von Azure PowerShell).For Az module installation instructions, see Install Azure PowerShell.

Zum Anpassen Ihrer Azure-SSIS IR benötigen Sie die folgenden Elemente:To customize your Azure-SSIS IR, you need the following items:

InstructionsInstructions

  1. Wenn Sie Ihre Azure-SSIS IR mit PowerShell einrichten oder neu konfigurieren möchten, müssen Sie Azure PowerShell herunterladen und installieren.If you want to set up or reconfigure your Azure-SSIS IR with PowerShell, download and install Azure PowerShell. Fahren Sie bei benutzerdefinierten Express-Setups mit Schritt 4 fort.For express custom setups, skip to step 4.

  2. Bereiten Sie Ihr benutzerdefiniertes Setupskript und die zugehörigen Dateien (z. B. BAT-, CMD-, EXE-, DLL-, MSI- oder PS1-Dateien) vor.Prepare your custom setup script and its associated files (for example, .bat, .cmd, .exe, .dll, .msi, or .ps1 files).

    • Sie benötigen dazu die Skriptdatei main.cmd. Sie ist der Einstiegspunkt für Ihr benutzerdefiniertes Setup.You must have a script file named main.cmd, which is the entry point of your custom setup.
    • Um sicherzustellen, dass das Skript im Hintergrund ausgeführt werden kann, empfehlen wir, es zuerst auf Ihrem lokalen Computer zu testen.To ensure that the script can be executed silently, we recommend that you test it on your local machine first.
    • Wenn Sie möchten, dass zusätzliche Protokolle, die von anderen Tools (z. B. msiexec.exe) generiert wurden, in Ihren Container hochgeladen werden, geben Sie die vordefinierte Umgebungsvariable, CUSTOM_SETUP_SCRIPT_LOG_DIR, als Protokollordner in Ihren Skripts an (z. B. msiexec/i xxx.msi/quiet/lv %CUSTOM_SETUP_SCRIPT_LOG_DIR%\install.log).If you want additional logs generated by other tools (for example, msiexec.exe) to be uploaded to your container, specify the predefined environment variable, CUSTOM_SETUP_SCRIPT_LOG_DIR, as the log folder in your scripts (for example, msiexec /i xxx.msi /quiet /lv %CUSTOM_SETUP_SCRIPT_LOG_DIR%\install.log).
  3. Laden Sie Azure Storage-Explorer herunter, installieren und öffnen Sie ihn.Download, install, and open Azure Storage Explorer. Gehen Sie folgendermaßen vor:To do so:

    a.a. Klicken Sie unter (Lokal und angefügt) mit der rechten Maustaste auf Speicherkonten, und wählen Sie dann Verbindung mit Azure Storage herstellen aus.Under (Local and Attached), right-click Storage Accounts, and then select Connect to Azure storage.

    Verbinden mit Azure Storage

    b.b. Aktivieren Sie Einen Speicherkontonamen und -schlüssel verwenden, und klicken Sie dann auf Weiter.Select Use a storage account name and key, and then select Next.

    Verwenden eines Speicherkontonamens und -schlüssels

    c.c. Geben Sie Ihren Azure Storage-Kontonamen und -schlüssel ein, und wählen Sie Weiter und dann Verbinden aus.Enter your Azure storage account name and key, select Next, and then select Connect.

    Bereitstellen des Speicherkontonamens und -schlüssels

    d.d. Klicken Sie unter Ihrem verbundenen Azure Storage-Konto mit der rechten Maustaste auf Blobcontainer, wählen Sie Blobcontainer erstellen aus, und benennen Sie den neuen Container.Under your connected Azure storage account, right-click Blob Containers, select Create Blob Container, and name the new container.

    Erstellen eines Blobcontainers

    e.e. Wählen Sie den neuen Container aus, und laden Sie Ihr benutzerdefiniertes Setupskript und die zugehörigen Dateien hoch.Select the new container, and upload your custom setup script and its associated files. Stellen Sie sicher, dass Sie main.cmd auf die oberste Ebene Ihres Containers und nicht in einen Ordner hochladen.Make sure that you upload main.cmd at the top level of your container, not in any folder. Vergewissern Sie sich außerdem, dass Ihr Container nur die erforderlichen Dateien für das benutzerdefinierte Setup enthält, damit das spätere Herunterladen in Ihre Azure-SSIS IR nicht lange dauert.Also ensure that your container contains only the necessary custom setup files, so that downloading them to your Azure-SSIS IR later won't take a long time. Die maximale Dauer für ein benutzerdefiniertes Setup ist zurzeit auf 45 Minuten festgelegt, bevor ein Timeout eintritt. Diese Dauer umfasst die Zeit zum Herunterladen aller Dateien aus Ihrem Container und deren Installation in der Azure-SSIS IR.The maximum duration of a custom setup is currently set at 45 minutes before it times out. This includes the time to download all files from your container and install them on the Azure-SSIS IR. Wenn das Setup mehr Zeit erfordert, erstellen Sie ein Supportticket.If setup requires more time, raise a support ticket.

    Hochladen von Dateien in den Blobcontainer

    f.f. Klicken Sie mit der rechten Maustaste auf den Container, und wählen Sie dann Shared Access Signature abrufen aus.Right-click the container, and then select Get Shared Access Signature.

    Abrufen der Shared Access Signature für den Container

    g.g. Erstellen Sie den SAS-URI für Ihren Container mit einer ausreichend langen Ablaufzeit sowie mit Lese-, Schreib- und Auflistungsberechtigungen.Create the SAS URI for your container with a sufficiently long expiration time and with read/write/list permission. Den SAS-URI benötigen Sie jedes Mal zum Herunterladen und Ausführen Ihres benutzerdefinierten Setupskripts und der zugehörigen Dateien, wenn für einen Knoten Ihrer Azure-SSIS IR ein Reimaging durchgeführt oder er neu gestartet wird.You need the SAS URI to download and run your custom setup script and its associated files whenever any node of your Azure-SSIS IR is reimaged or restarted. Schreibberechtigungen sind zum Hochladen der Setupausführungsprotokolle erforderlich.You need write permission to upload setup execution logs.

    Wichtig

    Stellen Sie sicher, dass der SAS-URI nicht abläuft und dass die benutzerdefinierten Setupressourcen während des gesamten Lebenszyklus Ihrer Azure-SSIS IR (vom Erstellen bis zum Löschen) immer verfügbar sind – insbesondere dann, wenn Sie Ihre Azure-SSIS IR während dieses Zeitraums regelmäßig beenden und starten.Ensure that the SAS URI doesn't expire and the custom setup resources are always available during the whole lifecycle of your Azure-SSIS IR, from creation to deletion, especially if you regularly stop and start your Azure-SSIS IR during this period.

    Generieren der Shared Access Signature für den Container

    h.h. Kopieren und speichern Sie den SAS-URI des Containers.Copy and save the SAS URI of your container.

    Kopieren und Speichern der Shared Access Signature

  4. Wenn Sie Ihre Azure-SSIS IR über eine Data Factory-Benutzeroberfläche einrichten oder neu konfigurieren, können Sie benutzerdefinierte Setups hinzufügen oder entfernen, indem Sie im Abschnitt Erweiterte Einstellungen des Bereichs Integration Runtime-Setup das Kontrollkästchen Azure-SSIS Integration Runtime mit zusätzlichen Systemkonfigurationen/Komponenteninstallationen anpassen aktivieren.When you set up or reconfigure your Azure-SSIS IR with a data factory UI, you can add or remove custom setups by selecting the Customize your Azure-SSIS Integration Runtime with additional system configurations/component installations check box in the Advanced Settings section of the Integration runtime setup pane.

    Wenn Sie benutzerdefinierte Standard-Setups hinzufügen möchten, geben Sie den SAS-URI Ihres Containers im Feld SAS-URI des Containers für benutzerdefinierte Setups ein.If you want to add standard custom setups, enter the SAS URI of your container in the Custom setup container SAS URI box.

    Wenn Sie benutzerdefinierte Express-Setups hinzufügen möchten, wählen Sie Neu aus, um den Bereich Benutzerdefiniertes Express-Setup hinzufügen zu öffnen, und wählen Sie dann in der Dropdownliste Typ des benutzerdefinierten Express-Setups den gewünschten Typ aus:If you want to add express custom setups, select New to open the Add express custom setup pane, and then select a type in the Express custom setup type drop-down list:

    • Wenn Sie den Typ Befehl „cmdkey“ ausführen auswählen, können Sie die Zugriffsanmeldeinformationen für Ihre Dateifreigaben oder Azure Files-Freigaben in Azure-SSIS IR beibehalten, indem Sie in den Feldern /Add, /User und /Pass die Namen Ihres Zielcomputers oder Ihrer Domäne, Ihres Kontos oder Ihres Benutzers sowie den Kontoschlüssel oder das Kennwort eingeben.If you select the Run cmdkey command type, you can persist access credentials for your file shares or Azure Files shares on Azure-SSIS IR by entering your targeted computer name or domain name, account name or username, and account key or password in the /Add, /User, and /Pass boxes. Dies ist vergleichbar mit der Ausführung des Windows-Befehls cmdkey auf Ihrem lokalen Computer.This is similar to running the Windows cmdkey command on your local machine.

    • Wenn Sie den Typ Umgebungsvariable hinzufügen auswählen, können Sie Windows-Umgebungsvariablen hinzufügen, die in Ihren in der Azure-SSIS IR ausgeführten Paketen verwendet werden sollen, indem Sie in den Feldern Variablenname und Variablenwert den Namen und den Wert Ihrer Umgebungsvariablen eingeben.If you select the Add environment variable type, you can add Windows environment variables to use in your packages that run on the Azure-SSIS IR by entering your environment variable name and value in the Variable name and Variable value boxes. Dies ist vergleichbar mit der Ausführung des Windows-Befehls set auf Ihrem lokalen Computer.This is similar to running the Windows set command on your local machine.

    • Wenn Sie den Typ Lizenzierte Komponente installieren auswählen, können Sie in der Dropdownliste Komponentenname eine integrierte Komponente unserer ISV-Partner auswählen:If you select the Install licensed component type, you can then select an integrated component from our ISV partners in the Component name drop-down list:

      • Wenn Sie die Komponente Task Factory von SentryOne auswählen, können Sie die Task Factory-Komponentensuite von SentryOne in Ihrer Azure-SSIS IR installieren, indem Sie im Feld Lizenzschlüssel den erworbenen Produktlizenzschlüssel eingeben.If you select the SentryOne's Task Factory component, you can install the Task Factory suite of components from SentryOne on your Azure-SSIS IR by entering the product license key that you purchased from them in the License key box. Die aktuelle integrierte Version ist 2019.4.3.The current integrated version is 2019.4.3.

      • Wenn Sie die Komponente HEDDA.IO von oh22 auswählen, können Sie die HEDDA.IO-Datenqualitäts-/Bereinigungskomponente von oh22 in Ihrer Azure-SSIS IR installieren, nachdem Sie den entsprechenden Dienst erworben haben.If you select the oh22's HEDDA.IO component, you can install the HEDDA.IO data quality/cleansing component from oh22 on your Azure-SSIS IR after purchasing their service. Die aktuelle integrierte Version ist 1.0.13.The current integrated version is 1.0.13.

      • Wenn Sie die Komponente SQLPhonetics.NET von oh22 auswählen, können Sie die SQLPhonetics.NET-Datenqualitäts-/Zuordnungskomponente von oh22 in Ihrer Azure-SSIS IR installieren, indem Sie im Feld Lizenzschlüssel den erworbenen Produktlizenzschlüssel eingeben.If you select the oh22's SQLPhonetics.NET component, you can install the SQLPhonetics.NET data quality/matching component from oh22 on your Azure-SSIS IR by entering the product license key that you purchased from them in the License key box. Die aktuelle integrierte Version ist 1.0.43.The current integrated version is 1.0.43.

      • Wenn Sie die Komponente KingswaySoft's SSIS Integration Toolkit auswählen, können Sie die Connector-Sammlung SSIS Integration Toolkit für Apps für CRM/ERP/Marketing/Zusammenarbeit, z. B. Microsoft Dynamics/SharePoint/Project Server, Oracle/Salesforce Marketing Cloud usw., von KingswaySoft in Ihrer Azure-SSIS Integration Runtime installieren, indem Sie den erworbenen Produktlizenzschlüssel im Feld Lizenzschlüssel eingeben.If you select the KingswaySoft's SSIS Integration Toolkit component, you can install the SSIS Integration Toolkit suite of connectors for CRM/ERP/marketing/collaboration apps, such as Microsoft Dynamics/SharePoint/Project Server, Oracle/Salesforce Marketing Cloud, etc. from KingswaySoft on your Azure-SSIS IR by entering the product license key that you purchased from them in the License key box. Die aktuelle integrierte Version ist 2019.2.The current integrated version is 2019.2.

      • Wenn Sie die Komponente KingswaySoft's SSIS Productivity Pack auswählen, können Sie die Komponentensammlung SSIS Productivity Pack von KingswaySoft in Ihrer Azure-SSIS Integration Runtime installieren, indem Sie den erworbenen Produktlizenzschlüssel im Feld Lizenzschlüssel eingeben.If you select the KingswaySoft's SSIS Productivity Pack component, you can install the SSIS Productivity Pack suite of components from KingswaySoft on your Azure-SSIS IR by entering the product license key that you purchased from them in the License key box. Die aktuelle integrierte Version ist 10.0.The current integrated version is 10.0.

      • Wenn Sie die Komponente Theobald Software's Xtract IS auswählen, können Sie die Xtract IS-Suite von Connectors für das SAP-System (ERP, S/4HANA, BW) aus Theobald Software in Ihrer Azure-SSIS IR installieren, indem Sie die erworbene Produktlizenzdatei in das Feld Lizenzdatei ziehen und ablegen/hochladen.If you select the Theobald Software's Xtract IS component, you can install the Xtract IS suite of connectors for SAP system (ERP, S/4HANA, BW) from Theobald Software on your Azure-SSIS IR by dragging & dropping/uploading the product license file that you purchased from them into the License file box. Die aktuelle integrierte Version ist 6.1.1.3.The current integrated version is 6.1.1.3.

    Die hinzugefügten benutzerdefinierten Express-Setups werden im Abschnitt Erweiterte Einstellungen angezeigt.Your added express custom setups will appear in the Advanced Settings section. Wenn Sie sie entfernen möchten, können Sie die entsprechenden Kontrollkästchen aktivieren und dann Löschen auswählen.To remove them, select their check boxes, and then select Delete.

    Erweiterte Einstellungen bei benutzerdefinierten Setups

  5. Wenn Sie Ihre Azure-SSIS IR mit PowerShell einrichten oder neu konfigurieren, können Sie die benutzerdefinierten Setups hinzufügen oder entfernen, indem Sie das Cmdlet Set-AzDataFactoryV2IntegrationRuntime ausführen, bevor Sie die Azure-SSIS IR starten.When you set up or reconfigure your Azure-SSIS IR with PowerShell, you can add or remove the custom setups by running the Set-AzDataFactoryV2IntegrationRuntime cmdlet before you start your Azure-SSIS IR.

    $ResourceGroupName = "[your Azure resource group name]"
    $DataFactoryName = "[your data factory name]"
    $AzureSSISName = "[your Azure-SSIS IR name]"
    # Custom setup info: Standard/express custom setups
    $SetupScriptContainerSasUri = "" # OPTIONAL to provide a SAS URI of blob container for standard custom setup where your script and its associated files are stored
    $ExpressCustomSetup = "[RunCmdkey|SetEnvironmentVariable|SentryOne.TaskFactory|oh22is.SQLPhonetics.NET|oh22is.HEDDA.IO|KingswaySoft.IntegrationToolkit|KingswaySoft.ProductivityPack|Theobald.XtractIS or leave it empty]" # OPTIONAL to configure an express custom setup without script
    
    # Add custom setup parameters if you use standard/express custom setups
    if(![string]::IsNullOrEmpty($SetupScriptContainerSasUri))
    {
        Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
            -DataFactoryName $DataFactoryName `
            -Name $AzureSSISName `
            -SetupScriptContainerSasUri $SetupScriptContainerSasUri
    }
    if(![string]::IsNullOrEmpty($ExpressCustomSetup))
    {
        if($ExpressCustomSetup -eq "RunCmdkey")
        {
            $addCmdkeyArgument = "YourFileShareServerName or YourAzureStorageAccountName.file.core.windows.net"
            $userCmdkeyArgument = "YourDomainName\YourUsername or azure\YourAzureStorageAccountName"
            $passCmdkeyArgument = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourPassword or YourAccessKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.CmdkeySetup($addCmdkeyArgument, $userCmdkeyArgument, $passCmdkeyArgument)
        }
        if($ExpressCustomSetup -eq "SetEnvironmentVariable")
        {
            $variableName = "YourVariableName"
            $variableValue = "YourVariableValue"
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.EnvironmentVariableSetup($variableName, $variableValue)
        }
        if($ExpressCustomSetup -eq "SentryOne.TaskFactory")
        {
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }
        if($ExpressCustomSetup -eq "oh22is.SQLPhonetics.NET")
        {
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }
        if($ExpressCustomSetup -eq "oh22is.HEDDA.IO")
        {
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup)
        }
        if($ExpressCustomSetup -eq "KingswaySoft.IntegrationToolkit")
        {
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }
        if($ExpressCustomSetup -eq "KingswaySoft.ProductivityPack")
        {
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString("YourLicenseKey")
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }    
        if($ExpressCustomSetup -eq "Theobald.XtractIS")
        {
            $jsonData = Get-Content -Raw -Path YourLicenseFile.json
            $jsonData = $jsonData -replace '\s',''
            $jsonData = $jsonData.replace('"','\"')
            $licenseKey = New-Object Microsoft.Azure.Management.DataFactory.Models.SecureString($jsonData)
            $setup = New-Object Microsoft.Azure.Management.DataFactory.Models.ComponentSetup($ExpressCustomSetup, $licenseKey)
        }
        # Create an array of one or more express custom setups
        $setups = New-Object System.Collections.ArrayList
        $setups.Add($setup)
    
        Set-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
            -DataFactoryName $DataFactoryName `
            -Name $AzureSSISName `
            -ExpressCustomSetup $setups
    }
    Start-AzDataFactoryV2IntegrationRuntime -ResourceGroupName $ResourceGroupName `
        -DataFactoryName $DataFactoryName `
        -Name $AzureSSISName `
        -Force
    

    Nachdem Ihr benutzerdefiniertes Standard-Setup abgeschlossen und Ihre Azure-SSIS IR gestartet wurde, finden Sie die Standardausgabe von main.cmd und andere Ausführungsprotokolle im Ordner main.cmd.log Ihres Speichercontainers.After your standard custom setup finishes and your Azure-SSIS IR starts, you can find the standard output of main.cmd and other execution logs in the main.cmd.log folder of your storage container.

  6. Wenn Sie einige Beispiele für benutzerdefinierte Standard-Setups anzeigen möchten, stellen Sie über Azure Storage-Explorer eine Verbindung zu unserem Container „Öffentliche Vorschau“ her.To view some samples of standard custom setups, connect to our Public Preview container by using Azure Storage Explorer.

    a.a. Klicken Sie unter (Lokal und angefügt) mit der rechten Maustaste auf Speicherkonten, und wählen Sie nacheinander Mit Azure-Speicher verbinden, Verbindungszeichenfolge oder SAS-URI verwenden und Weiter aus.Under (Local and Attached), right-click Storage Accounts, select Connect to Azure storage, select Use a connection string or a shared access signature URI, and then select Next.

    Herstellen einer Verbindung zum Azure-Speicher mit Shared Access Signature

    b.b. Wählen Sie SAS-URI verwenden aus, und geben Sie dann im Feld URI den folgenden SAS-URI ein:Select Use a SAS URI and then, in the URI box, enter the following SAS URI:

    https://ssisazurefileshare.blob.core.windows.net/publicpreview?sp=rl&st=2020-03-25T04:00:00Z&se=2025-03-25T04:00:00Z&sv=2019-02-02&sr=c&sig=WAD3DATezJjhBCO3ezrQ7TUZ8syEUxZZtGIhhP6Pt4I%3D

    Bereitstellen von Shared Access Signature für den Container

    c.c. Wählen Sie Weiter und anschließend Verbinden aus.Select Next, and then select Connect.

    d.d. Wählen Sie im linken Bereich den verbundenen Container publicpreview aus, und doppelklicken Sie dann auf den Ordner CustomSetupScript.In the left pane, select the connected publicpreview container, and then double-click the CustomSetupScript folder. In diesem Ordner befinden sich die folgenden Elemente:In this folder are the following items:

    • Der Ordner Beispiel mit einem benutzerdefinierten Setup zum Installieren eines einfachen Tasks auf jedem Knoten Ihrer Azure-SSIS IR.A Sample folder, which contains a custom setup to install a basic task on each node of your Azure-SSIS IR. Der Task hat keine Funktion, bleibt aber ein paar Sekunden im Standbymodus.The task does nothing but sleep for a few seconds. Außerdem enthält der Ordner den Ordner gacutil, dessen gesamter Inhalt (gacutil.exe, gacutil.exe.config und 1033\ gacutlrc.dll) unverändert in Ihren Container kopiert werden kann.The folder also contains a gacutil folder, whose entire contents (gacutil.exe, gacutil.exe.config, and 1033\gacutlrc.dll) can be copied as is to your container.

    • Der Ordner UserScenarios mit mehreren Beispielen für benutzerdefinierte Setups von echten Benutzerszenarien.A UserScenarios folder, which contains several custom setup samples from real user scenarios.

      Inhalt des Containers „Öffentliche Vorschau“

    e.e. Doppelklicken Sie auf den Ordner UserScenarios, um die folgenden Elemente zu suchen:Double-click the UserScenarios folder to find the following items:

    • Den Ordner .NET FRAMEWORK 3.5 mit einem benutzerdefinierten Setupskript (main.cmd) zum Installieren einer früheren Version von .NET Framework, das für benutzerdefinierte Komponenten auf jedem Knoten Ihrer Azure-SSIS IR möglicherweise erforderlich ist.A .NET FRAMEWORK 3.5 folder, which contains a custom setup script (main.cmd) to install an earlier version of the .NET Framework that might be required for custom components on each node of your Azure-SSIS IR.

    • Den Ordner BCP mit einem benutzerdefinierten Setupskript (main.cmd) zum Installieren von SQL Server-Befehlszeilenprogrammen (MsSqlCmdLnUtils.msi), einschließlich des Massenkopierprogramms (bcp), auf jedem Knoten Ihrer Azure-SSIS IR.A BCP folder, which contains a custom setup script (main.cmd) to install SQL Server command-line utilities (MsSqlCmdLnUtils.msi), including the bulk copy program (bcp), on each node of your Azure-SSIS IR.

    • Den Ordner EXCEL mit einem benutzerdefinierten Setupskript (main.cmd) zum Installieren von C#-Assemblys und -Bibliotheken, die Sie in Skripttasks zum dynamischen Lesen und Schreiben von Excel-Dateien auf jedem Knoten Ihrer Azure-SSIS IR verwenden können.An EXCEL folder, which contains a custom setup script (main.cmd) to install C# assemblies and libraries that you can use in script tasks to dynamically read and write Excel files on each node of your Azure-SSIS IR.

      Laden Sie zuerst ExcelDataReader.dll und DocumentFormat.OpenXml.dll herunter, und laden Sie dann alle zusammen mit main.cmd in Ihren Container hoch.First, download ExcelDataReader.dll and DocumentFormat.OpenXml.dll, and then upload them all together with main.cmd to your container. Wenn Sie nur den standardmäßigen Excel-Verbindungs-Manager, die Excel-Quelle und das Excel-Ziel verwenden möchten, ist die erforderliche Access-Redistributable bereits in Ihrer Azure-SSIS IR vorinstalliert, sodass Sie kein benutzerdefiniertes Setup durchführen müssen.Alternatively, if you want to use only the standard Excel Connection Manager, Excel source, and Excel destination, the required access redistributable is already preinstalled on your Azure-SSIS IR, so you don't need any custom setup.

    • Den Ordner MYSQL ODBC mit einem benutzerdefinierten Setupskript (main.cmd) zum Installieren der MySQL ODBC-Treibers auf jedem Knoten Ihrer Azure-SSIS IR.A MYSQL ODBC folder, which contains a custom setup script (main.cmd) to install the MySQL ODBC drivers on each node of your Azure-SSIS IR. Mit diesem Setup können Sie den ODBC-Verbindungs-Manager, die Quelle und das Ziel für die Verbindung zum MySQL-Server verwenden.This setup lets you use the ODBC Connection Manager, source, and destination to connect to the MySQL server.

      Laden Sie zuerst die neuesten 64-Bit- und 32-Bit-Versionen der MySQL ODBC-Treiberinstallationsprogramme herunter (z. B. mysql-connector-odbc-8.0.13-winx64.msi und mysql-connector-odbc-8.0.13-win32.msi), und laden Sie dann alle zusammen mit main.cmd in Ihren Container hoch.First, download the latest 64-bit and 32-bit versions of the MySQL ODBC driver installers (for example, mysql-connector-odbc-8.0.13-winx64.msi and mysql-connector-odbc-8.0.13-win32.msi), and then upload them all together with main.cmd to your container.

    • Den Ordner ORACLE ENTERPRISE mit einem benutzerdefinierten Setupskript (main.cmd) und einer Konfigurationsdatei für die unbeaufsichtigte Installation (client.rsp) zum Installieren der Oracle-Connectors und des OCI-Treibers auf jedem Knoten Ihrer Azure-SSIS IR Enterprise Edition.An ORACLE ENTERPRISE folder, which contains a custom setup script (main.cmd) and silent installation config file (client.rsp) to install the Oracle connectors and OCI driver on each node of your Azure-SSIS IR Enterprise Edition. Mit diesem Setup können Sie den Oracle-Verbindungs-Manager, die Quelle und das Ziel für die Verbindung zum Oracle-Server verwenden.This setup lets you use the Oracle Connection Manager, source, and destination to connect to the Oracle server.

      Laden Sie zuerst Microsoft Connectors v5.0 für Oracle (AttunitySSISOraAdaptersSetup.msi und AttunitySSISOraAdaptersSetup64.msi) aus Microsoft Download Center sowie den neuesten Oracle-Client (z. B winx64_12102_client.zip) aus Oracle herunter, und laden Sie dann alle zusammen mit main.cmd und client.rsp in Ihren Container hoch.First, download Microsoft Connectors v5.0 for Oracle (AttunitySSISOraAdaptersSetup.msi and AttunitySSISOraAdaptersSetup64.msi) from Microsoft Download Center and the latest Oracle client (for example, winx64_12102_client.zip) from Oracle, and then upload them all together with main.cmd and client.rsp to your container. Wenn Sie TNS bei der Herstellung einer Verbindung mit Oracle verwenden, müssen Sie auch die Datei tnsnames.ora herunterladen, bearbeiten und in Ihren Container hochladen, damit sie während des Setups in den Oracle-Installationsordner kopiert werden kann.If you use TNS to connect to Oracle, you also need to download tnsnames.ora, edit it, and upload it to your container, so it can be copied to the Oracle installation folder during setup.

    • Den Ordner ORACLE STANDARD ADO.NET mit einem benutzerdefinierten Setupskript (main.cmd) zum Installieren des Oracle ODP.NET-Treibers auf jedem Knoten Ihrer Azure-SSIS IR.An ORACLE STANDARD ADO.NET folder, which contains a custom setup script (main.cmd) to install the Oracle ODP.NET driver on each node of your Azure-SSIS IR. Mit diesem Setup können Sie den ADO.NET-Verbindungs-Manager, die Quelle und das Ziel für die Verbindung zum Oracle-Server verwenden.This setup lets you use the ADO.NET Connection Manager, source, and destination to connect to the Oracle server.

      Laden Sie zuerst den neuesten Oracle ODP.NET-Treiber herunter (z. B. ODP.NET_Managed_ODAC122cR1.zip), und laden Sie ihn dann zusammen mit main.cmd in Ihren Container hoch.First, download the latest Oracle ODP.NET driver (for example, ODP.NET_Managed_ODAC122cR1.zip), and then upload it together with main.cmd to your container.

    • Den Ordner ORACLE STANDARD ODBC mit einem benutzerdefinierten Setupskript (main.cmd) zum Installieren des Oracle ODBC-Treibers und Konfigurieren des Datenquellennamens (DSN) auf jedem Knoten Ihrer Azure-SSIS IR.An ORACLE STANDARD ODBC folder, which contains a custom setup script (main.cmd) to install the Oracle ODBC driver and configure the data source name (DSN) on each node of your Azure-SSIS IR. Bei diesem Setup können Sie den ODBC-Verbindungs-Manager, die Quelle und das Ziel oder den Power Query-Verbindungs-Manager und die Quelle mit dem ODBC-Datenquellentyp verwenden, um eine Verbindung zum Oracle-Server herzustellen.This setup lets you use the ODBC Connection Manager, source, and destination or Power Query Connection Manager and source with the ODBC data source type to connect to the Oracle server.

      Laden Sie zuerst das neueste Oracle Instant Client-Paket (Basic-Paket oder Basic Lite-Paket) und das ODBC-Paket herunter, und laden Sie dann alle zusammen mit main.cmd in Ihren Container hoch:First, download the latest Oracle Instant Client (Basic Package or Basic Lite Package) and ODBC Package, and then upload them all together with main.cmd to your container:

      • Herunterladen von 64-Bit-Paketen (Basic-Paket: instantclient-basic-windows.x64-18.3.0.0.0dbru.zip; Basic Lite-Paket: instantclient-basiclite-windows.x64-18.3.0.0.0dbru.zip; ODBC-Paket: instantclient-odbc-windows.x64-18.3.0.0.0dbru.zip)Download 64-bit packages (Basic Package: instantclient-basic-windows.x64-18.3.0.0.0dbru.zip; Basic Lite Package: instantclient-basiclite-windows.x64-18.3.0.0.0dbru.zip; ODBC Package: instantclient-odbc-windows.x64-18.3.0.0.0dbru.zip)
      • Herunterladen von 32-Bit-Paketen (Basic-Paket: instantclient-basic-nt-18.3.0.0.0dbru.zip; Basic Lite-Paket: instantclient-basiclite-nt-18.3.0.0.0dbru.zip; ODBC-Paket: instantclient-odbc-nt-18.3.0.0.0dbru.zip)Download 32-bit packages (Basic Package: instantclient-basic-nt-18.3.0.0.0dbru.zip; Basic Lite Package: instantclient-basiclite-nt-18.3.0.0.0dbru.zip; ODBC Package: instantclient-odbc-nt-18.3.0.0.0dbru.zip)
    • Den Ordner ORACLE STANDARD OLEDB mit einem benutzerdefinierten Setupskript (main.cmd) zum Installieren des Oracle OLE DB-Treibers auf jedem Knoten Ihrer Azure-SSIS IR.An ORACLE STANDARD OLEDB folder, which contains a custom setup script (main.cmd) to install the Oracle OLEDB driver on each node of your Azure-SSIS IR. Mit diesem Setup können Sie den OLE DB-Verbindungs-Manager, die Quelle und das Ziel für die Verbindung zum Oracle-Server verwenden.This setup lets you use the OLEDB Connection Manager, source, and destination to connect to the Oracle server.

      Laden Sie zuerst den neuesten Oracle OLE DB-Treiber herunter (z. B. ODAC122010Xcopy_x64.zip), und laden Sie ihn dann zusammen mit main.cmd in Ihren Container hoch.First, download the latest Oracle OLEDB driver (for example, ODAC122010Xcopy_x64.zip), and then upload it together with main.cmd to your container.

    • Den Ordner POSTGRESQL ODBC mit einem benutzerdefinierten Setupskript (main.cmd) zum Installieren des PostgreSQL ODBC-Treibers auf jedem Knoten Ihrer Azure-SSIS IR.A POSTGRESQL ODBC folder, which contains a custom setup script (main.cmd) to install the PostgreSQL ODBC drivers on each node of your Azure-SSIS IR. Mit diesem Setup können Sie den ODBC-Verbindungs-Manager, die Quelle und das Ziel für die Verbindung zum PostgreSQL-Server verwenden.This setup lets you use the ODBC Connection Manager, source, and destination to connect to the PostgreSQL server.

      Laden Sie zuerst die neuesten 64-Bit- und 32-Bit-Versionen der PostgreSQL-ODBC-Treiberinstallationsprogramme herunter (z. B. psqlodbc_x64. msi und psqlodbc_x86. msi), und laden Sie dann alle zusammen mit main.cmd in Ihren Container hoch.First, download the latest 64-bit and 32-bit versions of PostgreSQL ODBC driver installers (for example, psqlodbc_x64.msi and psqlodbc_x86.msi), and then upload them all together with main.cmd to your container.

    • Den Ordner SAP BW mit einem benutzerdefinierten Setupskript (main.cmd) zum Installieren der .NET-Connector-Assembly von SAP (librfc32.dll) auf jedem Knoten Ihrer Azure-SSIS IR Enterprise Edition.A SAP BW folder, which contains a custom setup script (main.cmd) to install the SAP .NET connector assembly (librfc32.dll) on each node of your Azure-SSIS IR Enterprise Edition. Mit diesem Setup können Sie den SAP Business Warehouse (BW)-Verbindungs-Manager, die Quelle und das Ziel für die Verbindung zum SAP BW-Server verwenden.This setup lets you use the SAP Business Warehouse (BW) Connection Manager, source, and destination to connect to the SAP BW server.

      Laden Sie zuerst die 64-Bit- oder 32-Bit-Version von librfc32.dll aus dem SAP-Installationsordner zusammen mit main.cmd in Ihren Container hoch.First, upload the 64-bit or the 32-bit version of librfc32.dll from the SAP installation folder together with main.cmd to your container. Das Skript kopiert dann die SAP-Assembly während des Setups in den Ordner %windir%\SysWow64 oder %windir%\System32.The script then copies the SAP assembly to the %windir%\SysWow64 or %windir%\System32 folder during setup.

    • Den Ordner STORAGE mit einem benutzerdefinierten Setupskript (main.cmd) zum Installieren von Azure PowerShell auf jedem Knoten Ihrer Azure-SSIS IR.A STORAGE folder, which contains a custom setup script (main.cmd) to install Azure PowerShell on each node of your Azure-SSIS IR. Bei diesem Setup können Sie SSIS-Pakete bereitstellen und ausführen, die PowerShell-Skripts zum Bearbeiten Ihres Azure Storage-Kontos ausführen.This setup lets you deploy and run SSIS packages that run PowerShell scripts to manipulate your Azure storage account.

      Kopieren Sie main.cmd, ein Beispiel für AzurePowerShell.msi (oder verwenden Sie die neueste Version) und storage.ps1 in Ihren Container.Copy main.cmd, a sample AzurePowerShell.msi (or use the latest version), and storage.ps1 to your container. Verwenden Sie PowerShell.dtsx als Vorlage für Ihre Pakete.Use PowerShell.dtsx as a template for your packages. In der Paketvorlage sind der Azure Blob-Download-Task, der storage.ps1 als modifizierbares PowerShell-Skript herunterlädt, und der Task „Prozess ausführen“ zusammengefasst, der das Skript auf jedem Knoten ausführt.The package template combines an Azure Blob download task, which downloads storage.ps1 as a modifiable PowerShell script, and an Execute process task, which executes the script on each node.

    • Der Ordner TERADATA, der ein benutzerdefiniertes Setupskript (main.cmd), die zugehörige Datei (install.cmd) und die Installer-Pakete ( .msi) enthält.A TERADATA folder, which contains a custom setup script (main.cmd), its associated file (install.cmd), and installer packages (.msi). Diese Dateien installieren die Teradata-Connectors, die Teradata Parallel Transporter (TPT)-API und den ODBC-Treiber auf jedem Knoten Ihrer Azure-SSIS IR Enterprise Edition.These files install the Teradata connectors, the Teradata Parallel Transporter (TPT) API, and the ODBC driver on each node of your Azure-SSIS IR Enterprise Edition. Mit diesem Setup können Sie den Teradata-Verbindungs-Manager, die Quelle und das Ziel für die Verbindung zum Teradata-Server verwenden.This setup lets you use the Teradata Connection Manager, source, and destination to connect to the Teradata server.

      Laden Sie zuerst die ZIP-Datei „Teradata Tools und Utilities 15.x“ herunter (z. B. TeradataToolsAndUtilitiesBase__windows_indep.15.10.22.00.zip), und laden Sie sie dann zusammen mit den zuvor erwähnten Dateien .cmd und .msi Dateien in Ihren Container hoch.First, download the Teradata Tools and Utilities 15.x zip file (for example, TeradataToolsAndUtilitiesBase__windows_indep.15.10.22.00.zip), and then upload it together with the previously mentioned .cmd and .msi files to your container.

    • Den Ordner TLS 1.2 mit einem benutzerdefinierten Setupskript (main.cmd) zur Verwendung einer starken Kryptografie/eines sichereren Netzwerkprotokolls (TLS 1.2) und zum Deaktivieren von älteren SSL/TLS-Versionen auf jedem Knoten Ihrer Azure-SSIS IR.A TLS 1.2 folder, which contains a custom setup script (main.cmd) to use strong cryptography/more secure network protocol (TLS 1.2) and disable older SSL/TLS versions on each node of your Azure-SSIS IR.

    • Den Ordner ZULU OPENJDK Ordner mit einem benutzerdefinierten Setupskript (main.cmd) und einer PowerShell-Datei (install_openjdk.ps1) zum Installieren des Zulu OpenJDK auf jedem Knoten Ihrer Azure-SSIS IR.A ZULU OPENJDK folder, which contains a custom setup script (main.cmd) and PowerShell file (install_openjdk.ps1) to install the Zulu OpenJDK on each node of your Azure-SSIS IR. Dieses Setup ermöglicht Ihnen die Verwendung von Azure Data Lake Store- und Flexible File-Connectors zur Verarbeitung von ORC- und Parquet-Dateien.This setup lets you use Azure Data Lake Store and Flexible File connectors to process ORC and Parquet files. Weitere Informationen finden Sie unter Azure Feature Pack für Integration Services.For more information, see Azure Feature Pack for Integration Services.

      Laden Sie zuerst das neueste Zulu OpenJDK herunter (z. B. zulu8.33.0.1-jdk8.0.192-win_x64.zip), und laden Sie es dann zusammen mit main.cmd und install_openjdk.ps1 in Ihren Container hoch.First, download the latest Zulu OpenJDK (for example, zulu8.33.0.1-jdk8.0.192-win_x64.zip), and then upload it together with main.cmd and install_openjdk.ps1 to your container.

      Ordner im Ordner „Benutzerszenarios“

    f.f. Zum Ausprobieren dieser Beispiele für ein benutzerdefiniertes Setup kopieren Sie den Inhalt aus dem ausgewählten Ordner in Ihren Container.To try these custom setup samples, copy the content from the selected folder to your container.

    Wenn Sie Ihre Azure-SSIS IR über die Data Factory-Benutzeroberfläche einrichten oder neu konfigurieren, aktivieren Sie im Abschnitt Erweiterte Einstellungen das Kontrollkästchen Azure-SSIS Integration Runtime mit zusätzlichen Systemkonfigurationen/Komponenteninstallationen anpassen, und geben Sie dann den SAS-URI Ihres Containers im Feld SAS-URI des Containers für benutzerdefinierte Setups ein.When you set up or reconfigure your Azure-SSIS IR by using the Data Factory UI, select the Customize your Azure-SSIS Integration Runtime with additional system configurations/component installations check box on the Advanced Settings section, and then enter the SAS URI of your container in the Custom setup container SAS URI box.

    Wenn Sie Ihre Azure-SSIS IR mit PowerShell einrichten oder neu konfigurieren, führen Sie das Cmdlet Set-AzDataFactoryV2IntegrationRuntime mit dem SAS-URI Ihres Containers als Wert für den Parameter SetupScriptContainerSasUri aus.When you set up or reconfigure your Azure-SSIS IR with PowerShell, run the Set-AzDataFactoryV2IntegrationRuntime cmdlet with the SAS URI of your container as the value for SetupScriptContainerSasUri parameter.

Nächste SchritteNext steps