Set-CMRemoteConnectionProfileConfigurationItem

  • Referenz
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 remote eine Verbindung mit Computern von außerhalb der Domäne oder über das Internet herzustellen.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Ändern eines Remoteverbindungsprofil-Konfigurationselements

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

Mit diesem Befehl wird das Konfigurationselement des Remoteverbindungsprofils mit der ID AAA0004D geändert. In diesem Fall werden die Eigenschaften EnablePrimaryUsers, EnableTSConnectionund EnableTSFirewallRule auf $False festgelegt.

Parameter

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Gibt eine Beschreibung für ein Remoteverbindungsprofil an.

Type:String
Aliases:LocalizedDescription
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Digest

Type:ConfigurationItem
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-DigestPath

Type:String
Aliases:DesiredConfigurationDigestPath
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DigestXml

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Enable

Type:Boolean
Aliases:EnableConnectionSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableNla

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnablePrimaryUser

Type:Boolean
Aliases:EnablePrimaryUsers
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableTSFirewallRule

Gibt an, ob Windows Firewall-Ausnahmen 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.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Id

Gibt ein Array von IDs für Remoteverbindungsprofile an.

Type:Int32
Aliases:CIId, CI_ID
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Gibt ein Remoteverbindungsprofilobjekt an. Verwenden Sie das Cmdlet Get-CMRemoteConnectionProfileConfigurationItem, um ein Remoteverbindungsprofil abzurufen.

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt ein Array von Namen von Remoteverbindungsprofilen an.

Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Gibt den neuen Namen für das Remoteverbindungsprofil an.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RDGatewayServer

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.DesiredConfigurationManagement.ConfigurationItem

Ausgaben

System.Object