Get-DAServer
Displays the properties of the DirectAccess (DA) server.
Syntax
Get-DAServer
[-ComputerName <String>]
[[-EntrypointName] <String>]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
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.
Examples
EXAMPLE 1
PS C:\>Get-DAServer
DAInstallType : FullInstall
InternetInterface : Private Internet
InternalInterface : Private Corpnet
ConnectToAddress : 192.168.0.2
SslCertificate : [Subject]
CN=192.168.0.2
[Issuer]
CN=192.168.0.2
[Serial Number]
44442E555EE4CC999F9C4BB8E33AAAAA
[Not Before]
23-01-2012 03:21:52
[Not After]
22-01-2017 19:31:51
[Thumbprint]
D9BB718F6F1502967F5B3E2F59DEE9F00B9C2F5A
GpoName : contoso.com\DirectAccess Server Settings
InternalIPv6Prefix : 2002:836B:1:1::/64
ClientIPv6Prefix : 2002:836B:1:1000::/64
UserAuthentication : UserPasswd
ComputerCertAuthentication : Disabled
IPsecRootCertificate :
IntermediateRootCertificate : False
TeredoState : Disabled
IsSingleNic : False
IsNatDeployed : False
HealthCheck : Disabled
This example displays the properties of the local DA server.
Parameters
-AsJob
Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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.
Type: | CimSession[] |
Aliases: | Session |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Specifies the IPv4 or IPv6 address, or host name, of the computer on which the DA server computer specific tasks should be run.
Type: | String |
Aliases: | Cn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EntrypointName
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.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ThrottleLimit
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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
Outputs
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.