Set-CMRemoteConnectionProfileConfigurationItem

Modul:

ConfigurationManager

Ändert ein Remoteverbindungsprofil.

Syntax

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>]

Beschreibung

Das Cmdlet Set-CMRemoteConnectionProfileConfigurationItem ändert ein Remoteverbindungsprofil. Clientcomputer verwenden Remoteverbindungsprofile, um eine Remoteverbindung mit Computern von außerhalb der Domäne oder über das Internet herzustellen.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Ändern eines Konfigurationselements für ein Remoteverbindungsprofil

PS XYZ:\> Set-CMRemoteConnectionProfileConfigurationItem -ID "AAA0004D" -EnablePrimaryUsers $False -EnableTSConnection $False -EnableTSFirewallRule $False

Dieser Befehl ändert das Konfigurationselement des Remoteverbindungsprofils mit der ID AAA0004D. In diesem Fall sind die Eigenschaften EnablePrimaryUsers, EnableTSConnection und EnableTSFirewallRule auf $False festgelegt.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Description

Gibt eine Beschreibung für ein Remoteverbindungsprofil an.

Typ:	String
Aliase:	LocalizedDescription
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Digest

Typ:	ConfigurationItem
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-DigestPath

Typ:	String
Aliase:	DesiredConfigurationDigestPath
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DigestXml

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Enable

Typ:	Boolean
Aliase:	EnableConnectionSettings
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EnableNla

Gibt an, ob Verbindungen nur von Computern zugelassen werden sollen, auf denen Remotedesktop mithilfe der Authentifizierung auf Netzwerkebene ausgeführt wird.

Typ:	Boolean
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EnablePrimaryUser

Typ:	Boolean
Aliase:	EnablePrimaryUsers
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EnableTSConnection

Gibt an, ob Remoteverbindungen mit Clientcomputern zugelassen werden sollen. Wenn Sie einen Wert für diesen Parameter angeben, müssen Sie Werte für die Parameter EnablePrimaryUsers und EnableTSFirewallRule angeben.

Typ:	Boolean
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EnableTSFirewallRule

Gibt an, ob Windows-Firewallausnahmen für Verbindungen in Windows-Domänen und in privaten Netzwerken zugelassen werden sollen. Wenn Sie einen Wert für diesen Parameter angeben, müssen Sie Werte für die Parameter EnablePrimaryUsers und EnableTSConnections angeben.

Typ:	Boolean
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Id

Gibt ein Array von IDs für Remoteverbindungsprofile an.

Typ:	Int32
Aliase:	CIId, CI_ID
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Gibt ein Remoteverbindungsprofilobjekt an. Verwenden Sie zum Abrufen eines Remoteverbindungsprofils das Cmdlet Get-CMRemoteConnectionProfileConfigurationItem.

Typ:	IResultObject
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Name

Gibt ein Array von Namen von Remoteverbindungsprofilen an.

Typ:	String
Aliase:	LocalizedDisplayName
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-NewName

Gibt den neuen Namen für das Remoteverbindungsprofil an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RDGatewayServer

Gibt den Hostnamen und Port des Remotedesktopgatewayservers an, z. B. Boston.gateway.Contoso.com:8080.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.DesiredConfigurationManagement.ConfigurationItem

Ausgaben

System.Object

Ähnliche Themen

• New-CMRemoteConnectionProfileConfigurationItem