Open in the explorer

Allow only selected Microsoft Entra tenant IDs

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › Dev Tunnels
Supported on
Tunnel CLI 1.0.1249 or later; Visual Studio: 17.9.3 or later, Preview 17.10.0 or later; VSCode: 1.88.0-insider or later, stable 1.88.0 or later
ADMX file
TunnelsPolicies.admx
Internal name
TunnelsPolicies/RestrictedTenantAccess

Explanation

Users must authenticate within the given tenant list to access Dev Tunnels. When enabling this policy, multiple tenant IDs can be added by using a semicolon or a comma to separate each. This includes Dev Tunnels in Visual Studio, port forwarding built into Visual Studio Code, the devtunnel CLI, and the Visual Studio Code Remote - Tunnels extension.
For more information, see: https://aka.ms/devtunnels/policies

Registry

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\DevTunnels
Value name
TenantsRestricted
StateValue written
Enablednot defined in the ADMX (see the options below)
Disablednot defined in the ADMX (see the options below)

PowerShell

PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.

The ADMX does not specify the value written when enabled; the GPO editor usually writes REG_DWORD 1 (enabled) / 0 (disabled). The commands below use 1/0 as an assumption.

Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.

Enable

# Enable: TunnelsPolicies/RestrictedTenantAccess
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\DevTunnels'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# The ADMX does not specify the value written; the GPO editor usually writes REG_DWORD 1 (enabled) / 0 (disabled)
Set-ItemProperty -Path $k -Name 'TenantsRestricted' -Value 1 -Type DWord  # assumed value (not defined in the ADMX)
# Enter Allowed Tenant IDs
Set-ItemProperty -Path $k -Name 'AllowedTenantIdList' -Value '<value>' -Type ExpandString

Disable

# Disable: TunnelsPolicies/RestrictedTenantAccess
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\DevTunnels'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# The ADMX does not specify the value written; the GPO editor usually writes REG_DWORD 1 (enabled) / 0 (disabled)
Set-ItemProperty -Path $k -Name 'TenantsRestricted' -Value 0 -Type DWord  # assumed value (not defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": TunnelsPolicies/RestrictedTenantAccess
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\DevTunnels'
Remove-ItemProperty -Path $k -Name 'TenantsRestricted' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'AllowedTenantIdList' -ErrorAction SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Enter Allowed Tenant IDs:DevTunnels_RestrictedTenantAccess_TextBoxText boxtextAllowedTenantIdListREG_EXPAND_SZ
Required · Max length: 150

Application

Visual Studio (+ Dev Tunnels) (Microsoft) — October 2026 templates

October 2026 templates from pl4nty/web-admx-tool.