SetByExternalServer method of the PS_DANetworkLocationServer class
This cmdlet is used to configure the Network Location Server. It can be present on the DirectAccess server or on some other highly available server.
Syntax
uint32 SetByExternalServer(
[in] string Url,
[in] boolean CheckReachability,
[in] string ComputerName,
[in] boolean Force,
[in] boolean PassThru,
[out] DANetworkLocationServer cmdletOutput
);
Parameters
-
Url [in]
-
This URL represents the highly available external server used as the NLS (provides clients with location information)
-
CheckReachability [in]
-
If this parameter is specified then the cmdlet will perform a reachability check to the specified URL and will configure the Network Location Server on that server only if the URL is reachable
-
ComputerName [in]
-
IPv4/IPv6 address or hostname of the machine on which the DirectAccess server machine specific tasks should be executed
-
Force [in]
-
Switch parameter used to suppress user confirmation prompts for the following conditions. When suppressed the cmdlet assumes user confirmation for the below mentioned changes: 1. Creation of self-signed cert when configuring the NLS on the DA server 2. Moving the NLS from the DA server to an external server - the corresponding URL on the DA server is decommissioned. Clients outside corpnet will not receive the updated policies. When they enter corpnet the URL will be inaccessible and they will be detected to be outside corpnet. As a result they will not be able to access corp resources
-
PassThru [in]
-
Returns the network location server policy object. By default this cmdlet does not generate any output
-
cmdletOutput [out]
-
- Where the Network Location Server is configured - on the DA server itself or on a different server: 2. URL (if it is configured on a different server) 3. Certificate (if it is configured on the DA server) 4. Reachability to Network Location Server (if on a different server whether the URL is reachable or not)
Requirements
Minimum supported client |
None supported |
Minimum supported server |
Windows Server 2012 |
Namespace |
Root\Microsoft\Windows\RemoteAccess |
MOF |
|
DLL |
|