Windows PowerShell command on Get-command Add-VpnConnectionTriggerDnsConfiguration

NAME
    Add-VpnConnectionTriggerDnsConfiguration
    
SYNOPSIS
    Adds a DNS suffix or name to VPN connection trigger properties.
    
    
SYNTAX
    Add-VpnConnectionTriggerDnsConfiguration [-ConnectionName]  [-DnsSuffix]  [[-DnsIPAddress] 
    ] [-CimSession ] [-Force] [-PassThru] [-ThrottleLimit ] [-Confirm] [-WhatIf] 
    []
    
    
DESCRIPTION
    The Add-VpnConnectionTriggerDnsConfiguration cmdlet adds a Domain Name System (DNS) suffix or name to the DNS 
    trigger properties for a client. If you specify a DNS IP address for the suffix or name, when the client accesses 
    a resource in the suffix, the client starts a virtual private network (VPN) connection. If you do not specify a 
    DNS IP address for a DNS suffix or name, accessing the suffix or name does not trigger the VPN connection.
    
    If you previously ran the Set-VpnConnectionTriggerTrustedNetwork cmdlet with the DefaultDnsSuffixes parameter 
    specified, the current cmdlet adds the DNS suffix to the trusted Network list. This cmdlet does not add DNS 
    suffixes that do not have DNS server addresses.
    

PARAMETERS
    -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.
        
        Required?                    false
        Position?                    named
        Default value                none
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -ConnectionName 
        Specifies the name of a VPN connection profile. To view existing VPN connection profiles, use the 
        Get-VpnConnection cmdlet.
        
        Required?                    true
        Position?                    2
        Default value                none
        Accept pipeline input?       true(ByPropertyName)
        Accept wildcard characters?  false
        
    -DnsIPAddress []
        Specifies an array IP addresses of DNS servers for the DNS suffix. You can use both IPv4 and IPv6 addresses.
        
        If you do not specify a DNS server, the client does not start a VPN connection when the client accesses a 
        resource with the DNS suffix or name.
        
        Required?                    false
        Position?                    4
        Default value                none
        Accept pipeline input?       true(ByPropertyName)
        Accept wildcard characters?  false
        
    -DnsSuffix 
        Specifies a DNS suffix.
        
        Required?                    true
        Position?                    3
        Default value                none
        Accept pipeline input?       true(ByPropertyName)
        Accept wildcard characters?  false
        
    -Force []
        Forces the command to run without asking for user confirmation.
        
        Required?                    false
        Position?                    named
        Default value                none
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -PassThru []
        Returns an object representing the item with which you are working. By default, this cmdlet does not generate 
        any output. If you specify this parameter, the cmdlet returns the VpnConnectionTriggerDnsConfiguration object 
        that contains DNS suffixes and corresponding DNS servers.
        
        Required?                    false
        Position?                    named
        Default value                none
        Accept pipeline input?       false
        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 PowerShellr 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.
        
        Required?                    false
        Position?                    named
        Default value                none
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -Confirm []
        Prompts you for confirmation before running the cmdlet.Prompts you for confirmation before running the cmdlet.
        
        Required?                    false
        Position?                    named
        Default value                false
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -WhatIf []
        Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs. 
        The cmdlet is not run.
        
        Required?                    false
        Position?                    named
        Default value                false
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer, PipelineVariable, and OutVariable. For more information, see 
        about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216). 
    
INPUTS
        
    
     
    
OUTPUTS
        Microsoft.Management.Infrastructure.CimInstance#VpnConnectionTriggerDnsConfiguration
    
     
    
    Example 1: Add a DNS suffix
    
    PS C:\>Add-VpnConnectionTriggerDnsConfiguration -ConnectionName "Contoso" -DnsSuffix "washington.contoso.com" 
    -DnsIPAddress "172.16.12.23" -PassThru
    WARNING: The suffix washington.contoso.com will be automatically added to 
    
    the trusted network detection list. Any subsequent addition/removal of 
    
    suffixes from this cmdlet will be reflected in the trusted network 
    
    detection list. If you do not want this auto-population, remove the 
    
    suffixes from the trusted network detection list by using the 
    
    cmdlet Remove-VpnConnectionTriggerTrustedNetwork 
    
    ConnectionName       DnsSuffix            DnsIPAddress                             DnsSuffixSearchList
    
    --------------       ---------            ------------                             -------------------
    
    Contoso              washington.contos... {172.16.12.23}
    
    This command adds the DNS suffix washington.contoso.com to the trigger properties for the current client. The 
    command specifies the VPN connection profile named Contoso and an address for a DNS server for this suffix. The 
    command includes the PassThru parameter. Therefore, it returns the VPN connection DNS trigger properties for the 
    client.
    
    In this example, Trigger Trusted Network has the default value. Therefore the command adds the suffix to the 
    trusted network detection list.
    
    
    Example 2: Add a DNS suffix that has multiple DNS servers
    
    PS C:\>Add-VpnConnectionTriggerDnsConfiguration -ConnectionName "Contoso" -DnsSuffix "newyork.contoso.com" 
    -DnsIPAddress "172.16.12.3", "172.16.12.22" -PassThru
    ConnectionName       DnsSuffix            DnsIPAddress                             DnsSuffixSearchList
    
    --------------       ---------            ------------                             -------------------
    
    Contoso              newyork.contoso.com  {172.16.12.3, 172.16.12.22}
    
    This command adds the DNS suffix newyork.contoso.com to the trigger properties for the current client. The command 
    specifies the VPN connection profile named Contoso and multiple addresses for DNS servers. The command includes 
    the PassThru parameter. Therefore, it returns the VPN connection DNS trigger properties for the client.
    
    
    Example 3: Add a DNS suffix that does not trigger a VPN connection
    
    PS C:\>Add-VpnConnectionTriggerDnsConfiguration -ConnectionName "Contoso" -DnsSuffix "ras.washington.contoso.com" 
    -PassThru
    ConnectionName       DnsSuffix            DnsIPAddress                             DnsSuffixSearchList
    
    --------------       ---------            ------------                             -------------------
    
    Contoso              ras.washington.co...
    
    This command adds the DNS suffix ras.washington.contoso.com to the trigger properties for the current client. The 
    command specifies the VPN connection profile named Contoso. Unlike the previous examples, this command does not 
    specify an address for a DNS server. When this client accesses resources from ras.washington.contoso.com, it does 
    not trigger a VPN connection. The command includes the PassThru parameter. Therefore, it returns the VPN 
    connection DNS trigger properties for the client.
    
    
    
RELATED LINKS
    Get-VpnConnection 
    Remove-VpnConnectionTriggerDnsConfiguration 
    Set-VpnConnectionTriggerDnsConfiguration