mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-05-12 05:17:22 +00:00
201 lines
7.2 KiB
Markdown
201 lines
7.2 KiB
Markdown
---
|
||
title: PXLOGICAL configuration service provider
|
||
description: The PXLOGICAL configuration service provider is used to add, remove, or modify WAP logical and physical proxies by using WAP or the standard Windows techniques.
|
||
ms.assetid: b5fc84d4-aa32-4edd-95f1-a6a9c0feb459
|
||
ms.reviewer:
|
||
manager: dansimp
|
||
ms.author: dansimp
|
||
ms.topic: article
|
||
ms.prod: w10
|
||
ms.technology: windows
|
||
author: manikadhiman
|
||
ms.date: 06/26/2017
|
||
---
|
||
|
||
# PXLOGICAL configuration service provider
|
||
|
||
|
||
The PXLOGICAL configuration service provider is used to add, remove, or modify WAP logical and physical proxies by using WAP or the standard Windows techniques.
|
||
|
||
> **Note** This configuration service provider requires the ID\_CAP\_CSP\_FOUNDATION and ID\_CAP\_NETWORKING\_ADMIN capabilities to be accessed from a network configuration application.
|
||
|
||
|
||
The following shows the PXLOGICAL configuration service provider management object in tree format as used by OMA Client Provisioning for initial bootstrapping of the device. The OMA DM protocol is not supported by this configuration service provider.
|
||
|
||
```console
|
||
PXLOGICAL
|
||
----DOMAIN
|
||
----NAME
|
||
----PORT
|
||
-------PORTNBR
|
||
-------SERVICE
|
||
----PUSHENABLED
|
||
----PROXY-ID
|
||
----TRUST
|
||
----PXPHYSICAL
|
||
-------DOMAIN
|
||
-------PHYSICAL-PROXY-ID
|
||
-------PORT
|
||
---------PORTNBR
|
||
---------SERVICE
|
||
-------PUSHENABLED
|
||
-------PXADDR
|
||
-------PXADDRTYPE
|
||
-------TO-NAPID
|
||
```
|
||
|
||
|
||
The following shows the PXLOGICAL configuration service provider management object in tree format as used by OMA Client Provisioning for updating the bootstrapping of the device. The OMA DM protocol is not supported by this configuration service provider.
|
||
|
||
```console
|
||
PXLOGICAL
|
||
--PROXY-ID
|
||
----DOMAIN
|
||
----NAME
|
||
----PORT
|
||
-------PORTNBR
|
||
-------SERVICE
|
||
----PUSHENABLED
|
||
----TRUST
|
||
----PXPHYSICAL
|
||
-------PHYSICAL-PROXY-ID
|
||
----------DOMAIN
|
||
----------PORT
|
||
-------------PORTNBR
|
||
-------------SERVICE
|
||
----------PUSHENABLED
|
||
----------PXADDR
|
||
----------PXADDRTYPE
|
||
----------TO-NAPID
|
||
```
|
||
|
||
|
||
<a href="" id="pxphysical"></a>**PXPHYSICAL**
|
||
Defines a group of logical proxy settings.
|
||
|
||
The element's mwid attribute is a Microsoft provisioning XML attribute, and is optional when adding a NAP or a proxy. It is required when updating and deleting existing NAPs and proxies and must have its value set to 1.
|
||
|
||
<a href="" id="domain"></a>**DOMAIN**
|
||
Specifies the domain associated with the proxy (for example, "\*.com").
|
||
|
||
A Windows device supports only one proxy that does not have a DOMAIN parameter, or has an empty DOMAIN value. That is, the device only supports one default proxy. All other proxy configurations must have a DOMAIN parameter with a non-empty value. A query of this parameter returns a semicolon-delimited string of all domains associated with the proxy.
|
||
|
||
<a href="" id="name"></a>**NAME**
|
||
Specifies the name of the logical proxy.
|
||
|
||
When a list of proxies is displayed to the user they are displayed together in a single line, so the length of this value should be short for readability.
|
||
|
||
<a href="" id="port"></a>**PORT**
|
||
Defines the bindings between a port number and one or more protocols or services.
|
||
|
||
This configuration service provider can accept a maximum of two ports per physical proxy. A query of this characteristic returns information relating only to the first port.
|
||
|
||
<a href="" id="portnbr"></a>**PORTNBR**
|
||
Specifies the port number associated with some services on this proxy.
|
||
|
||
If the PORTNBR is 80 or 443, or the PORT characteristic is missing, it is treated as an HTTP proxy.
|
||
|
||
<a href="" id="service"></a>**SERVICE**
|
||
Specifies the service associated with the port number.
|
||
|
||
Windows supports accepting WAP push connectionless sessions over a Short Message Service (SMS) bearer for WAP push messages. Internet Explore uses HTTP protocol, not WAP proxy. A query of this parameter returns a semicolon-delimited string of services for only the first port.
|
||
|
||
<a href="" id="pushenabled"></a>**PUSHENABLED**
|
||
Specifies whether or not push operations are enabled.
|
||
|
||
If this element is used in PXLOGICAL, it applies to all of the PXPHYSICAL elements embedded in the PXLOGICAL element. A value of "0" indicates that the proxy does not support push operations. A value of "1" indicates that the proxy supports push operations.
|
||
|
||
<a href="" id="proxy-id"></a>**PROXY-ID**
|
||
Used during initial bootstrapping. Specifies the unique identifier of the logical proxy.
|
||
|
||
<a href="" id="proxy-id"></a>***PROXY-ID***
|
||
Used during bootstrapping updates. Specifies the unique identifier of the logical proxy.
|
||
|
||
The name of the **PROXY-ID** element is the same as the value passed during initial bootstrapping.
|
||
|
||
<a href="" id="trust"></a>**TRUST**
|
||
Specifies whether or not the physical proxies in this logical proxy are privileged. The SECPOLICY\_TRUSTED\_WAP\_PROXY security policy (4121) governs what roles can set this element.
|
||
|
||
<a href="" id="pxphysical"></a>**PXPHYSICAL**
|
||
Defines a group of physical proxy settings associated with the parent logical proxy.
|
||
|
||
The element's mwid attribute is a Microsoft provisioning XML attribute, and is optional when adding a NAP or a proxy. It is required when updating and deleting existing NAPs and proxies and must have its value set to 1.
|
||
|
||
<a href="" id="physical-proxy-id"></a>**PHYSICAL-PROXY-ID**
|
||
Used during initial bootstrapping. Specifies the identifier of the physical proxy.
|
||
|
||
When a list of proxies is displayed to the user they are displayed together in a single line, so the length of this value should be short for readability.
|
||
|
||
<a href="" id="physical-proxy-id"></a>***PHYSICAL-PROXY-ID***
|
||
Used during bootstrapping updates. Specifies the identifier of the physical proxy.
|
||
|
||
The name of the **PHYSICAL-PROXY-ID** element is the same as the value passed during initial bootstrapping.
|
||
|
||
<a href="" id="pxaddr"></a>**PXADDR**
|
||
Specifies the address of the physical proxy.
|
||
|
||
<a href="" id="pxaddrtype"></a>**PXADDRTYPE**
|
||
Specifies the format and protocol of the PXADDR element for a physical proxy.
|
||
|
||
The only values supported are "E164" and "IPv4".
|
||
|
||
<a href="" id="to-napid"></a>**TO-NAPID**
|
||
Specifies the network access point associated with this physical proxy. Only one per proxy is supported.
|
||
|
||
If **TO-NAPID** is used, the NAP whose **NAPID** is referred to by **TO-NAPID** must also be added.
|
||
|
||
## Microsoft Custom Elements
|
||
|
||
|
||
The following table shows the Microsoft custom elements that this configuration service provider supports for OMA Client Provisioning.
|
||
|
||
These features are available only for the device technique. In addition, the parameter-query and characteristic-query features are not supported for all PXPHYSICAL proxy parameters for all PXADDR types. All parameters can be queried when the PXPHYSICAL proxy PXADDRType is IPv4. For example, if a mobile operator queries the TO-NAPID parameter of a PXPHYSICAL proxy and the PXADDR Type is E164, a noparm is returned.
|
||
|
||
<table>
|
||
<colgroup>
|
||
<col width="50%" />
|
||
<col width="50%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="header">
|
||
<th>Feature</th>
|
||
<th>Available</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="odd">
|
||
<td><p>parm-query</p></td>
|
||
<td><p>Yes</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td><p>noparm</p></td>
|
||
<td><p>Yes</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td><p>nocharacteristic</p></td>
|
||
<td><p>Yes</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td><p>characteristic-query</p></td>
|
||
<td><p>Yes</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
## Related topics
|
||
|
||
|
||
[Configuration service provider reference](configuration-service-provider-reference.md)
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|