Freigeben über


New-CMRemoteConnectionProfileConfigurationItem

Erstellt ein Remoteverbindungsprofil.

Syntax

New-CMRemoteConnectionProfileConfigurationItem
   [-Description <String>]
   [-Enable <Boolean>]
   [-EnableNla <Boolean>]
   [-EnablePrimaryUser <Boolean>]
   [-EnableTSConnection <Boolean>]
   [-EnableTSFirewallRule <Boolean>]
   -Name <String>
   [-RDGatewayServer <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-CMRemoteConnectionProfileConfigurationItem erstellt 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: Erstellen eines Konfigurationselements für ein Remoteverbindungsprofil

PS XYZ:\> New-CMRemoteConnectionProfileConfigurationItem -Name "EuropeanRemoteConnections" -EnablePrimaryUsers $True -EnableTSConnection $True -EnableTSFirewallRule $True

Dieser Befehl erstellt ein Konfigurationselement für das Remoteverbindungsprofil mit dem Namen EuropeanRemoteConnections. Für dieses Element sind die Eigenschaften EnablePrimaryUsers, EnableTSConnection und EnableTSFirewall auf $True 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

-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

-Name

Gibt einen Namen für ein Remoteverbindungsprofil an.

Typ:String
Aliase:LocalizedDisplayName
Position:Named
Standardwert:None
Erforderlich:True
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

None

Ausgaben

IResultObject