Partager via


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]

  1. 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
RAMgmtPSProvider.mof
DLL
RAMgmtPSProvider.dll

See also

PS_DANetworkLocationServer