Get-DAServer

Get-DAServer

Displays the properties of the DirectAccess (DA) server.

Syntax

Parameter Set: Get0
Get-DAServer [[-EntrypointName] <String> ] [-AsJob] [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Detailed Description

The Get-DAServer cmdlet displays the properties of the DirectAccess (DA) server.

The output displayed consists of the following.

Global Configuration: These properties are applicable to the entire DA deployment.
-- DA installation configuration: full install or only manage-out.
-- Internal IPv6 prefix.
-- Authentication type.
-- IPsec root certificate: The certificate is always configured separately on every server, although the same certificate issued by same root is present on all DA servers.
-- Intermediate root certificate usage: enabled or disabled.
-- Computer certificate authentication: enabled or disabled.
-- DA server GPO name.
-- Health check: enabled or disabled.

For the following properties either the server-level or cluster level, if load balancing has been deployed, configuration is returned. If multi-site is deployed, then this configuration is applicable at the site-level and configuration for the specified site is displayed.
-- Client IPv6 prefix.
-- Teredo State.
-- Whether NAT is enabled.
-- Does DA server have a single network adapter or two network adapters.

The following are pure server-level properties that are returned. In a multi-site deployment if both the EntryPointName and ComputerName parameters are specified, but the ComputerName parameter value does not belong to that entry point name, then no values are returned for these properties. However, if only the EntryPointName parameter is specified or the ComputerName parameter value is also specified and belongs to the specified entry point name, then the configuration is retrieved from the server on which the cmdlet is run as follows.
-- Internet interface.
-- Internal interface.
-- SSL certificate.

Parameters

-AsJob

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CimSession<CimSession[]>

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ComputerName<String>

Specifies the IPv4 or IPv6 address, or host name, of the computer on which the DA server computer specific tasks should be run.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EntrypointName<String>

Specifies the identity of a site in a multi-site deployment and when specified indicates that the configuration of the DA server at that site should be retrieved.
If this parameter is not specified in a multi-site deployment then the entry point to which the server on which this cmdlet is run is used. The server could also be represented by using the ComputerName parameter.
If both this parameter and ComputerName parameter are specified and the computer name does not belong to the site represented by this parameter then this parameter takes precedence and the configuration is returned for it.

Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-ThrottleLimit<Int32>

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • None

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.Management.Infrastructure.CimInstance#MSFT_DAServer

    The Microsoft.Management.Infrastructure.CimInstance object is a wrapper class that displays Windows Management Instrumentation (WMI) objects. The path after the pound sign (#) provides the namespace and class name for the underlying WMI object.
    The output object contains the following properties:
    -- Type of DA installation: full or managed.
    -- Authentication type.
    -- Internal IPv6 prefix.
    -- Client IPHTTPS IPv6 prefix.
    -- Usage of computer certificate authorization for 1st tunnel: Enabled or Disabled.
    -- IPsec root certificate.
    -- Whether the IPsec root certificate is an intermediate root certificate.
    -- Status of Teredo: Enabled or Disabled.
    -- Whether the DA server is deployed behind NAT.
    -- Whether the configuration in which DA is deployed is a single or double network adapter.
    -- Name of the DA server GPO.
    -- Status of the health check.

Examples

EXAMPLE 1

This example displays the properties of the local DA server.

PS C:\> Get-DAServer

Get-DAServer

Get-RemoteAccess