DevicePolicyManager.SetAlwaysOnVpnPackage メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| SetAlwaysOnVpnPackage(ComponentName, String, Boolean) |
現在のユーザーの特定のアプリケーションを介して常時接続 VPN 接続を構成するために、デバイスまたはプロファイルの所有者によって呼び出されます。 |
| SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>) |
このバージョン |
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 アプリのパッケージ名、または null 既存の常時接続 VPN 構成を削除するパッケージ名。
- lockdownEnabled
- Boolean
true VPN が接続されていない場合、またはその false 他の場合はネットワークを禁止します。 これは、クリア時には影響しません。
- 属性
注釈
現在のユーザーの特定のアプリケーションを介して常時接続 VPN 接続を構成するために、デバイスまたはプロファイルの所有者によって呼び出されます。 この接続は、再起動後に自動的に許可され、保持されます。
常時オン機能をサポートするには、アプリでマニフェスト<で宣言する必要がありますandroid.net.VpnService><><。android.Manifest.permission#BIND_VPN_SERVICE/li li><>ターゲット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)されたすべてのロックダウン許可リストをクリアします。
set null を指定してこのメソッドをvpnPackage呼び出すことからandroid.os.Build.VERSION_CODES#S API 31始めて、この管理者によって以前に作成された場合にのみ、既存の構成が削除されます。ユーザーによって作成された VPN 構成を削除するには、 を使用UserManager#DISALLOW_CONFIG_VPNします。
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。
適用対象
SetAlwaysOnVpnPackage(ComponentName, String, Boolean, ICollection<String>)
このバージョン #setAlwaysOnVpnPackage(ComponentName, String, boolean) では、VPN が接続されていない場合に直接ネットワークにアクセスできるアプリのセットを管理者が指定できます。
[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 アプリのパッケージ名、または null 既存の常時接続 VPN 構成を削除する
- lockdownEnabled
- Boolean
true VPN が接続されていない場合、またはその false 他の場合はネットワークを禁止します。 これは、クリア時には影響しません。
- lockdownAllowlist
- ICollection<String>
VPN がロックダウン モードで接続されていない場合にネットワークに直接アクセスできるパッケージ。 クリアしても効果はありません。
- 属性
注釈
このバージョン #setAlwaysOnVpnPackage(ComponentName, String, boolean) では、VPN が接続されていない場合に直接ネットワークにアクセスできるアプリのセットを管理者が指定できます。 VPN がこれらのアプリを VPN に接続すると、その VPN の使用が許可されている場合は VPN に切り替わります。 システム アプリは常に VPN をバイパスできます。
パッケージがインストールまたはアンインストールされるときに、システムは許可リストを更新しません。管理アプリは、リストを最新の状態に保つためにこのメソッドを呼び出す必要があります。
false lockdownAllowlist の場合lockdownEnabledは無視されます。 IS またはtruelockdownAllowlist空のnull場合lockdownEnabled、システム アプリのみが VPN をバイパスできます。
常時接続 VPN パッケージを null 設定するか、ロックダウン許可リストをクリアします #setAlwaysOnVpnPackage(ComponentName, String, boolean) 。
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。