다음을 통해 공유


DevicePolicyManager.SetAlwaysOnVpnPackage 메서드

정의

오버로드

SetAlwaysOnVpnPackage(ComponentName, String, Boolean)

디바이스 또는 프로필 소유자가 현재 사용자에 대한 특정 애플리케이션을 통해 상시 VPN 연결을 구성하기 위해 호출합니다.

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

이 버전을 #setAlwaysOnVpnPackage(ComponentName, String, boolean) 사용하면 관리자가 VPN이 연결되지 않은 경우 네트워크에 직접 액세스할 수 있어야 하는 앱 집합을 지정할 수 있습니다.

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

매개 변수

vpnPackage
String

디바이스에 설치된 VPN 앱의 패키지 이름이거나 null 기존 상시 VPN 구성을 제거합니다.

lockdownEnabled
Boolean

true VPN이 연결되지 않았거나 false 연결되지 않은 경우 네트워킹을 허용하지 않습니다. 지우는 경우 아무런 영향을 주지 않습니다.

특성

설명

디바이스 또는 프로필 소유자가 현재 사용자에 대한 특정 애플리케이션을 통해 상시 VPN 연결을 구성하기 위해 호출합니다. 이 연결은 재부팅 후 자동으로 부여되고 유지됩니다.

Always-On 기능을 지원하려면 앱이 매니페스트 android.Manifest.permission#BIND_VPN_SERVICE< 에서 ul><li>를 android.net.VpnService 선언해야 합니다<./li li><>target android.os.Build.VERSION_CODES#N API 24 이상; and</li li>><not explicitly opt out of the feature through .<android.net.VpnService#SERVICE_META_DATA_SUPPORTS_ALWAYS_ON/li></ul> 지원되지 않는 VPN 앱의 패키지 이름으로 호출되면 호출이 실패합니다.

인수를 통해 lockdownEnabled 잠금을 사용하도록 설정하면 VPN 공급자의 실패로 인해 모든 앱에 대한 네트워킹이 중단될 위험이 있습니다. 이 메서드는 .에서 설정한 #setAlwaysOnVpnPackage(ComponentName, String, boolean, Set)잠금 허용 목록을 지웁니다.

이 메서드를 호출하여 android.os.Build.VERSION_CODES#S API 31 이 관리자가 이전에 만든 경우에만 기존 구성을 제거하도록 null 설정하여 이 메서드 vpnPackage 를 호출하기 시작합니다. 사용자가 UserManager#DISALLOW_CONFIG_VPN만든 VPN 구성을 제거하려면 .

에 대한 android.app.admin.DevicePolicyManager.setAlwaysOnVpnPackage(android.content.ComponentName, java.lang.String, boolean)Java 설명서

이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 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

매개 변수

vpnPackage
String

디바이스에 설치된 VPN 앱의 패키지 이름 또는 null 기존 Always-On VPN 구성 제거

lockdownEnabled
Boolean

true VPN이 연결되지 않았거나 false 연결되지 않은 경우 네트워킹을 허용하지 않습니다. 지우는 경우 아무런 영향을 주지 않습니다.

lockdownAllowlist
ICollection<String>

VPN이 잠금 모드에 있지만 연결되지 않은 경우 네트워크에 직접 액세스할 수 있는 패키지입니다. 지울 때 효과가 없습니다.

특성

설명

이 버전을 #setAlwaysOnVpnPackage(ComponentName, String, boolean) 사용하면 관리자가 VPN이 연결되지 않은 경우 네트워크에 직접 액세스할 수 있어야 하는 앱 집합을 지정할 수 있습니다. VPN이 연결되면 해당 VPN을 사용하도록 허용된 경우 이러한 앱이 VPN으로 전환됩니다. 시스템 앱은 항상 VPN을 무시할 수 있습니다.

패키지가 설치되거나 제거될 때 시스템에서 허용 목록을 업데이트하지 않습니다. 관리 앱은 이 메서드를 호출하여 목록을 최신 상태로 유지해야 합니다.

false lockdownAllowlist 인 경우 lockdownEnabled 는 무시됩니다. 있는 true 경우 또는 lockdownAllowlist 비어 있는 null 경우 lockdownEnabled 시스템 앱만 VPN을 바이패스할 수 있습니다.

Always-On VPN 패키지를 잠금 허용 목록으로 null 설정하거나 사용하도록 #setAlwaysOnVpnPackage(ComponentName, String, boolean) 설정합니다.

에 대한 android.app.admin.DevicePolicyManager.setAlwaysOnVpnPackage(android.content.ComponentName, java.lang.String, boolean, java.util.Set<java.lang.String>)Java 설명서

이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 2.5 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.

적용 대상