Allow only selected Microsoft Entra tenant IDs
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
| State | Value written |
|---|---|
| Enabled | not defined in the ADMX (see the options below) |
| Disabled | not 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 ExpandStringDisable
# 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 SilentlyContinueOptions (1)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Enter Allowed Tenant IDs:DevTunnels_RestrictedTenantAccess_TextBox | Text boxtext | AllowedTenantIdList | REG_EXPAND_SZ | Required · Max length: 150 |
Application
Visual Studio (+ Dev Tunnels) (Microsoft) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.