Document Details

Create Shared Self Hosted Integration Runtime Powershell
Home / Scan 41 / Create Shared Self Hosted Integration Runtime Powershell
❌
This page contains Windows bias

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Bias Types:
⚠️ powershell_heavy
⚠️ windows_first
⚠️ windows_tools
⚠️ missing_linux_example
Summary:
The documentation page demonstrates a strong Windows and PowerShell bias. All command-line examples are provided exclusively using PowerShell, with explicit instructions to use the Windows PowerShell ISE. The installation instructions for the integration runtime do not mention Linux or cross-platform alternatives, and there are no Bash, Azure CLI, or Linux-specific examples or guidance. The only scripting environment referenced is Windows-based, and the documentation does not address Linux users or provide parity for non-Windows environments.
Recommendations:
  • Provide equivalent Azure CLI examples for all PowerShell scripts, as Azure CLI is cross-platform and commonly used on Linux and macOS.
  • Include instructions for installing and registering the self-hosted integration runtime on Linux (if supported), or explicitly state platform limitations.
  • Replace or supplement references to 'Windows PowerShell ISE' with cross-platform editors or terminal instructions (e.g., VS Code, standard terminal).
  • Add a section or notes addressing Linux/macOS users, clarifying any differences or limitations, and providing alternative steps where possible.
  • Ensure download and installation instructions for the integration runtime explicitly mention supported platforms and provide links for all OS installers.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-07-12 23:44 #41 in_progress ❌ Biased
2025-07-12 00:58 #8 cancelled ✅ Clean
2025-07-10 05:06 #7 processing ✅ Clean

Flagged Code Snippets

# If input contains a PSH special character, e.g. "$", precede it with the escape character "`" like "`$". $SubscriptionName = "[Azure subscription name]" $ResourceGroupName = "[Azure resource group name]" $DataFactoryLocation = "EastUS" # Shared Self-hosted integration runtime information. This is a Data Factory compute resource for running any activities # Data factory name. Must be globally unique $SharedDataFactoryName = "[Shared Data factory name]" $SharedIntegrationRuntimeName = "[Shared Integration Runtime Name]" $SharedIntegrationRuntimeDescription = "[Description for Shared Integration Runtime]" # Linked integration runtime information. This is a Data Factory compute resource for running any activities # Data factory name. Must be globally unique $LinkedDataFactoryName = "[Linked Data factory name]" $LinkedIntegrationRuntimeName = "[Linked Integration Runtime Name]" $LinkedIntegrationRuntimeDescription = "[Description for Linked Integration Runtime]"
Connect-AzAccount Select-AzSubscription -SubscriptionName $SubscriptionName
New-AzResourceGroup -Location $DataFactoryLocation -Name $ResourceGroupName
Set-AzDataFactoryV2 -ResourceGroupName $ResourceGroupName ` -Location $DataFactoryLocation ` -Name $SharedDataFactoryName
$factory = Set-AzDataFactoryV2 -ResourceGroupName $ResourceGroupName ` -Location $DataFactoryLocation ` -Name $LinkedDataFactoryName
$SharedIR = Set-AzDataFactoryV2IntegrationRuntime ` -ResourceGroupName $ResourceGroupName ` -DataFactoryName $SharedDataFactoryName ` -Name $SharedIntegrationRuntimeName ` -Type SelfHosted ` -Description $SharedIntegrationRuntimeDescription
Get-AzDataFactoryV2IntegrationRuntimeKey ` -ResourceGroupName $ResourceGroupName ` -DataFactoryName $SharedDataFactoryName ` -Name $SharedIntegrationRuntimeName
New-AzRoleAssignment ` -ObjectId $factory.Identity.PrincipalId ` #MSI of the Data Factory with which it needs to be shared -RoleDefinitionName 'Contributor' ` -Scope $SharedIR.Id
Set-AzDataFactoryV2IntegrationRuntime ` -ResourceGroupName $ResourceGroupName ` -DataFactoryName $LinkedDataFactoryName ` -Name $LinkedIntegrationRuntimeName ` -Type SelfHosted ` -SharedIntegrationRuntimeResourceId $SharedIR.Id ` -Description $LinkedIntegrationRuntimeDescription
Remove-AzRoleAssignment ` -ObjectId $factory.Identity.PrincipalId ` -RoleDefinitionName 'Contributor' ` -Scope $SharedIR.Id
Remove-AzDataFactoryV2IntegrationRuntime ` -ResourceGroupName $ResourceGroupName ` -DataFactoryName $SharedDataFactoryName ` -Name $SharedIntegrationRuntimeName ` -LinkedDataFactoryName $LinkedDataFactoryName