New-DSGateway

Créer un Gateway

New-DSGateway -Name <string> -DevolutionsGatewayUrl <string> -TCPListeningPort <int>
 [-Description <string>] [-IsDefault] [-TokenDuration <int>] [-HealthCheckInterval <int>]
 [-ForceIpAddressForRdpConnections] [-AsLegacyResponse] [<CommonParameters>]

Créer un Gateway. Utiliser les paramètres pour créer le Gateway. Le module Devolutions Gateway est requis.

PS C:\> New-DSGateway -Name "New Gateway" -DevolutionsGatewayUrl "http://localhost" -TCPListeningPort 8181.

Créer un Gateway avec des informations minimales.

PS C:\> New-DSGateway -Name "New Default Gateway" -DevolutionsGatewayUrl "http://localhost" -TCPListeningPort 8181 -Description "A simple description" -IsDefault -ForceIpAddressForRdpConnections -TokenDuration 60 -HealthCheckInterval 240.

Créer le nouveau Gateway par défaut.

Dans les versions antérieures à 2024.2, de nombreux applets de commande DS retournaient un objet ServerResponse. Activer ce commutateur de compatibilité descendante permet aux scripts développés pour les versions antérieures de fonctionner correctement.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

Description du Gateway

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

URL pour atteindre le Devolutions Gateway. Doit être un URI valide et unique à ce Gateway.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

Forcer l'utilisation de l'adresse IP pour les connexions RDP.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

Intervalle de vérification de l'état en minutes. Par défaut, il est fixé à 60 minutes.

Type: System.Int32
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

Définir comme le Gateway par défaut

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

Nom du Gateway. La valeur sera tronquée.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

Port utilisé pour les sessions RDP et éventuellement les sessions SSH.

Type: System.Int32
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

Durée du jeton généré en minutes. Doit être comprise entre 1 et 120 minutes. Par défaut, elle est fixée à 5 minutes.

Type: System.Int32
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

Cet applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, et -WarningVariable. Pour plus d'informations, voir about_CommonParameters.

Pour plus d'informations, taper "Get-Help New-DSGateway -detailed". Pour des informations techniques, taper "Get-Help New-DSGateway -full".