DevicePolicyManager.SetAlwaysOnVpnPackage メソッド

定義

名前空間:: Android.App.Admin

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

名前	説明
SetAlwaysOnVpnPackage(ComponentName, String, Boolean)	現在のユーザーの特定のアプリケーションを介して常時接続 VPN 接続を構成するために、デバイスまたはプロファイルの所有者によって呼び出されます。
SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>)	VPN が接続されていないときにネットワークに直接アクセスできるアプリのセットを管理者が指定できるようにする `#setAlwaysOnVpnPackage(ComponentName, String, boolean)` のバージョン。

SetAlwaysOnVpnPackage(ComponentName, String, Boolean)

現在のユーザーの特定のアプリケーションを介して常時接続 VPN 接続を構成するために、デバイスまたはプロファイルの所有者によって呼び出されます。

[Android.Runtime.Register("setAlwaysOnVpnPackage", "(Landroid/content/ComponentName;Ljava/lang/String;Z)V", "GetSetAlwaysOnVpnPackage_Landroid_content_ComponentName_Ljava_lang_String_ZHandler", ApiSince=24)]
public virtual void SetAlwaysOnVpnPackage(Android.Content.ComponentName admin, string? vpnPackage, bool lockdownEnabled);

[<Android.Runtime.Register("setAlwaysOnVpnPackage", "(Landroid/content/ComponentName;Ljava/lang/String;Z)V", "GetSetAlwaysOnVpnPackage_Landroid_content_ComponentName_Ljava_lang_String_ZHandler", ApiSince=24)>]
abstract member SetAlwaysOnVpnPackage : Android.Content.ComponentName * string * bool -> unit
override this.SetAlwaysOnVpnPackage : Android.Content.ComponentName * string * bool -> unit

パラメーター

admin: ComponentName

vpnPackage: String

デバイスにインストールされている VPN アプリのパッケージ名。または既存の常時接続 VPN 構成を削除するために null 。

lockdownEnabled: Boolean

true VPN が接続されていない場合はネットワークを禁止するか、それ以外の場合は false 。これは、クリア時には影響しません。

属性: RegisterAttribute

注釈

現在のユーザーの特定のアプリケーションを介して常時接続 VPN 接続を構成するために、デバイスまたはプロファイルの所有者によって呼び出されます。この接続は、再起動後に自動的に許可され、保持されます。

常時接続機能をサポートするには、アプリがマニフェストでandroid.net.VpnService<><li>宣言し、android.Manifest.permission#BIND_VPN_SERVICE;</li><li>target android.os.Build.VERSION_CODES#N API 24 以上;および</li><li>android.net.VpnService#SERVICE_META_DATA_SUPPORTS_ALWAYS_ON.<を使用して機能を明示的にオプトアウトすることはできません/li></ul> サポートされていない VPN アプリのパッケージ名で呼び出された場合、呼び出しは失敗します。

lockdownEnabled引数を使用してロックダウンを有効にすると、VPN プロバイダーの障害によってすべてのアプリのネットワークが中断されるリスクが伴います。このメソッドは、 #setAlwaysOnVpnPackage(ComponentName, String, boolean, Set)によって設定されたロックダウン許可リストをクリアします。

vpnPackageを null に設定してこのメソッドを呼び出すandroid.os.Build.VERSION_CODES#S API 31から、この管理者によって以前に作成された場合にのみ、既存の構成が削除されます。ユーザーによって作成された VPN 構成を削除するには、UserManager#DISALLOW_CONFIG_VPNを使用します。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>)

VPN が接続されていないときにネットワークに直接アクセスできるアプリのセットを管理者が指定できるようにする #setAlwaysOnVpnPackage(ComponentName, String, boolean) のバージョン。

[Android.Runtime.Register("setAlwaysOnVpnPackage", "(Landroid/content/ComponentName;Ljava/lang/String;ZLjava/util/Set;)V", "GetSetAlwaysOnVpnPackage_Landroid_content_ComponentName_Ljava_lang_String_ZLjava_util_Set_Handler", ApiSince=29)]
public virtual void SetAlwaysOnVpnPackage(Android.Content.ComponentName admin, string? vpnPackage, bool lockdownEnabled, System.Collections.Generic.ICollection<string>? lockdownAllowlist);

[<Android.Runtime.Register("setAlwaysOnVpnPackage", "(Landroid/content/ComponentName;Ljava/lang/String;ZLjava/util/Set;)V", "GetSetAlwaysOnVpnPackage_Landroid_content_ComponentName_Ljava_lang_String_ZLjava_util_Set_Handler", ApiSince=29)>]
abstract member SetAlwaysOnVpnPackage : Android.Content.ComponentName * string * bool * System.Collections.Generic.ICollection<string> -> unit
override this.SetAlwaysOnVpnPackage : Android.Content.ComponentName * string * bool * System.Collections.Generic.ICollection<string> -> unit

パラメーター

admin: ComponentName

vpnPackage: String

デバイスにインストールされている VPN アプリのパッケージ名、または既存の always-on VPN 構成を削除するnull

lockdownEnabled: Boolean

true VPN が接続されていない場合はネットワークを禁止するか、それ以外の場合は false 。これは、クリア時には影響しません。

lockdownAllowlist: ICollection<String>

VPN がロックダウンモードで接続されていない場合にネットワークに直接アクセスできるパッケージ。クリアしても効果はありません。

属性: RegisterAttribute

注釈

VPN が接続されていないときにネットワークに直接アクセスできるアプリのセットを管理者が指定できるようにする #setAlwaysOnVpnPackage(ComponentName, String, boolean) のバージョン。 VPN がこれらのアプリを VPN に接続すると、その VPN の使用が許可されている場合は VPN に切り替わります。システムアプリは常に VPN をバイパスできます。

パッケージがインストールまたはアンインストールされるときに、システムは許可リストを更新しません。管理アプリは、リストを最新の状態に保つためにこのメソッドを呼び出す必要があります。

lockdownEnabledが false の場合、lockdownAllowlistは無視されます。 lockdownEnabledがtrueされ、lockdownAllowlistがnullまたは空の場合、システムアプリのみが VPN をバイパスできます。

always-on VPN パッケージを null に設定するか、 #setAlwaysOnVpnPackage(ComponentName, String, boolean) を使用すると、ロックダウン許可リストがクリアされます。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象