Set-CMRemoteConnectionProfileConfigurationItem
修改远程连接配置文件。
语法
Set-CMRemoteConnectionProfileConfigurationItem
[-Enable <Boolean>]
[-EnableNla <Boolean>]
[-EnablePrimaryUser <Boolean>]
[-EnableTSConnection <Boolean>]
[-EnableTSFirewallRule <Boolean>]
[-InputObject] <IResultObject>
[-RDGatewayServer <String>]
[-Description <String>]
[-Digest <ConfigurationItem>]
[-DigestPath <String>]
[-DigestXml <String>]
[-NewName <String>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMRemoteConnectionProfileConfigurationItem
[-Enable <Boolean>]
[-EnableNla <Boolean>]
[-EnablePrimaryUser <Boolean>]
[-EnableTSConnection <Boolean>]
[-EnableTSFirewallRule <Boolean>]
[-RDGatewayServer <String>]
[-Description <String>]
[-Digest <ConfigurationItem>]
[-DigestPath <String>]
[-DigestXml <String>]
[-Id] <Int32>
[-NewName <String>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMRemoteConnectionProfileConfigurationItem
[-Enable <Boolean>]
[-EnableNla <Boolean>]
[-EnablePrimaryUser <Boolean>]
[-EnableTSConnection <Boolean>]
[-EnableTSFirewallRule <Boolean>]
[-RDGatewayServer <String>]
[-Description <String>]
[-Digest <ConfigurationItem>]
[-DigestPath <String>]
[-DigestXml <String>]
[-Name] <String>
[-NewName <String>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
Set-CMRemoteConnectionProfileConfigurationItem cmdlet 修改远程连接配置文件。 客户端计算机使用远程连接配置文件从域外部或通过 Internet 远程连接到计算机。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：修改远程连接配置文件配置项目
PS XYZ:\> Set-CMRemoteConnectionProfileConfigurationItem -ID "AAA0004D" -EnablePrimaryUsers $False -EnableTSConnection $False -EnableTSFirewallRule $False此命令使用 ID AAA0004D 修改远程连接配置文件配置项目。 在这种情况下， EnablePrimaryUsers、 EnableTSConnection 和 EnableTSFirewallRule 属性都设置为 $False。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
指定远程连接配置文件的说明。
| 类型: | String |
| 别名: | LocalizedDescription |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Digest
| 类型: | ConfigurationItem |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-DigestPath
| 类型: | String |
| 别名: | DesiredConfigurationDigestPath |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DigestXml
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Enable
| 类型: | Boolean |
| 别名: | EnableConnectionSettings |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableNla
指示是否仅允许来自使用网络级别身份验证运行远程桌面的计算机的连接。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnablePrimaryUser
| 类型: | Boolean |
| 别名: | EnablePrimaryUsers |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableTSConnection
指示是否允许到客户端计算机的远程连接。 如果为此参数指定值，则必须指定 EnablePrimaryUsers 和 EnableTSFirewallRule 参数的值。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableTSFirewallRule
指示是否允许 Windows 域和专用网络上的连接出现 Windows 防火墙例外。 如果为此参数指定值，则必须指定 EnablePrimaryUsers 和 EnableTSConnections 参数的值。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Id
指定远程连接配置文件的 ID 数组。
| 类型: | Int32 |
| 别名: | CIId, CI_ID |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-InputObject
指定远程连接配置文件对象。 若要获取远程连接配置文件，请使用 Get-CMRemoteConnectionProfileConfigurationItem cmdlet。
| 类型: | IResultObject |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Name
指定远程连接配置文件的名称数组。
| 类型: | String |
| 别名: | LocalizedDisplayName |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-NewName
指定远程连接配置文件的新名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PassThru
添加此参数可返回一个对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RDGatewayServer
指定远程桌面网关服务器的主机名和端口，例如，Boston.gateway.Contoso.com:8080。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Microsoft.ConfigurationManagement.DesiredConfigurationManagement.ConfigurationItem
输出
System.Object