Ask Learn
Preview
Ask Learn is an AI assistant that can answer questions, clarify concepts, and define terms using trusted Microsoft documentation.
Please sign in to use Ask Learn.
Sign inThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Creates a remote connection profile.
New-CMRemoteConnectionProfileConfigurationItem
[-Description <String>]
[-Enable <Boolean>]
[-EnableNla <Boolean>]
[-EnablePrimaryUser <Boolean>]
[-EnableTSConnection <Boolean>]
[-EnableTSFirewallRule <Boolean>]
-Name <String>
[-RDGatewayServer <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
The New-CMRemoteConnectionProfileConfigurationItem cmdlet creates a remote connection profile. Client computers use remote connection profiles to remotely connect to computers from outside the domain or over the Internet.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>
. For more information, see getting started.
PS XYZ:\> New-CMRemoteConnectionProfileConfigurationItem -Name "EuropeanRemoteConnections" -EnablePrimaryUsers $True -EnableTSConnection $True -EnableTSFirewallRule $True
This command creates a remote connection profile configuration item named EuropeanRemoteConnections. For this item the EnablePrimaryUsers, EnableTSConnection, and EnableTSFirewall properties are all set to $True.
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Default value: | False |
Supports wildcards: | False |
DontShow: | False |
Aliases: | cf |
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
Specifies a description for a remote connection profile.
Type: | String |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | LocalizedDescription |
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
Type: | SwitchParameter |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
The New-CMRemoteConnectionProfileConfigurationItem cmdlet creates a remote connection profile. Client computers use remote connection profiles to remotely connect to computers from outside the domain or over the Internet.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>
. For more information, see getting started.
Type: | Boolean |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | EnableConnectionSettings |
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
Indicates whether to allow connections only from computers that run Remote Desktop by using Network Level Authentication.
Type: | Boolean |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
The New-CMRemoteConnectionProfileConfigurationItem cmdlet creates a remote connection profile. Client computers use remote connection profiles to remotely connect to computers from outside the domain or over the Internet.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>
. For more information, see getting started.
Type: | Boolean |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | EnablePrimaryUsers |
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
Indicates whether to allow remote connections to client computers. If you specify a value for this parameter, you must specify values for the EnablePrimaryUsers and EnableTSFirewallRule parameters.
Type: | Boolean |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
Indicates whether to allow Windows Firewall exceptions for connections in Windows domains and on private networks. If you specify a value for this parameter, you must specify values for the EnablePrimaryUsers and EnableTSConnections parameters.
Type: | Boolean |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
Type: | SwitchParameter |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
Specifies a name for a remote connection profile.
Type: | String |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | LocalizedDisplayName |
Position: | Named |
Mandatory: | True |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
Specifies the host name and port of the Remote Desktop gateway server, for example, Boston.gateway.Contoso.com:8080.
Type: | String |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
Shows what would happen if the cmdlet runs. The cmdlet doesn't run.
Type: | SwitchParameter |
Default value: | False |
Supports wildcards: | False |
DontShow: | False |
Aliases: | wi |
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Ask Learn is an AI assistant that can answer questions, clarify concepts, and define terms using trusted Microsoft documentation.
Please sign in to use Ask Learn.
Sign in