Document Details

Create Shared Self Hosted Integration Runtime Powershell
Home / Scan 2 / 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 Azure PowerShell, with explicit instructions to use Windows PowerShell ISE and references to installing Azure PowerShell on Windows. There are no examples or guidance for performing these tasks using cross-platform tools such as Azure CLI, Bash, or on Linux/macOS environments. The installer instructions for the self-hosted integration runtime do not clarify Linux support or alternatives.
Recommendations:
  • Provide equivalent Azure CLI examples for all PowerShell commands, as Azure CLI is cross-platform and works on Windows, Linux, and macOS.
  • Avoid referencing Windows-specific tools such as 'Windows PowerShell ISE' unless absolutely necessary; instead, use generic terms like 'terminal' or 'command line interface'.
  • Clarify whether the self-hosted integration runtime installer is available for Linux/macOS, and if not, explicitly state the platform requirements.
  • Include instructions or notes for users on Linux/macOS, even if only to clarify limitations or alternative approaches.
  • Reorganize sections so that cross-platform solutions (e.g., Azure CLI) are presented before or alongside Windows/PowerShell-specific instructions.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-09-16 00:00 #113 completed ✅ Clean
2025-09-15 00:00 #112 completed ✅ Clean
2025-09-14 00:00 #111 completed ✅ Clean
2025-09-13 00:00 #110 completed ✅ Clean
2025-09-12 00:00 #109 completed ✅ Clean
2025-09-11 00:00 #108 completed ✅ Clean
2025-09-10 00:00 #107 completed ✅ Clean
2025-09-09 00:00 #106 completed ✅ Clean
2025-09-08 00:00 #105 completed ✅ Clean
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ✅ Clean
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

New-AzResourceGroup -Location $DataFactoryLocation -Name $ResourceGroupName
# 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
$factory = Set-AzDataFactoryV2 -ResourceGroupName $ResourceGroupName ` -Location $DataFactoryLocation ` -Name $LinkedDataFactoryName
Set-AzDataFactoryV2 -ResourceGroupName $ResourceGroupName ` -Location $DataFactoryLocation ` -Name $SharedDataFactoryName
$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