Commands › Microsoft Teams

Get-CsExternalAccessPolicy

Microsoft Teams MicrosoftTeams Get-*

Returns information about the external access policies that have been configured for use in your organization.

Quick start script

# Get-CsExternalAccessPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Run and inspect
Get-CsExternalAccessPolicy | Format-List

# 3. Export for evidence / drift tracking
Get-CsExternalAccessPolicy | Export-Clixml .\CsExternalAccessPolicy-$(Get-Date -Format yyyyMMdd).xml

Syntax — 2 parameter sets

Identity (Default)

Get-CsExternalAccessPolicy [-Tenant <Guid>] [-Include <PolicyFilter>] [-ApplicableTo <UserIdParameter>]
 [[-Identity] <XdsIdentity>] [-LocalStore] [<CommonParameters>]

Filter

Get-CsExternalAccessPolicy [-Tenant <Guid>] [-Include <PolicyFilter>] [-ApplicableTo <UserIdParameter>]
 [-Filter <String>] [-LocalStore] [<CommonParameters>]

Parameters (6)

Parameter	Type	What it controls
-ApplicableTo	UserIdParameter	Returns a list of the external access policies that can be assigned to the specified user. For example, to return a collection of policies that can be assigned to the user kenmyer@litwareinc.com, use this command:
-Filter	String	Below Content Applies To: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015
-Identity	XdsIdentity	Unique Identity assigned to the policy when it was created. External access policies can be assigned at the global, site, or per-user scope. To refer to the global instance use this syntax: -Identity global. To refer...
-Include	PolicyFilter	PARAMVALUE: Automatic \| All \| SubscriptionDefaults \| TenantDefinedOnly
-LocalStore	SwitchParameter	Retrieves the external access policy data from the local replica of the Central Management store rather than from the Central Management store itself.
-Tenant	Guid	This parameter is reserved for internal Microsoft use.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.