Set-CMRemoteConnectionProfileConfigurationItem

模块:

ConfigurationManager

修改远程连接配置文件。

语法

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

相关链接

• New-CMRemoteConnectionProfileConfigurationItem