New-DSGatewaySecurity

Synopsis

Créer un nouvel objet GatewaySecurity

Syntaxe

__AllParameterSets

New-DSGatewaySecurity [-GatewayPermissionOverride <SecurityRoleOverride>]
 [-CustomGatewayPermissions <guid[]>] [-VaultRoleOverride <GatewayVaultRoleOverride>]
 [-CustomVaultAccess <guid[]>] [-RDPTokenReuseWindow <int>] [-DisallowDynamicConnections]
 [-DisallowPrivateVaults] [-DisallowRDPReconnection] [-DisableRdpProxyCredentialInjection]
 [<CommonParameters>]

Description

Créer un nouvel objet GatewaySecurity qui peut servir à configurer les paramètres de sécurité lors de la création ou de la mise à jour de passerelles. Ces paramètres peuvent aussi être configurés sur les jeux de règles de passerelle et les fermes de passerelles.

Exemples

Exemple 1

PS C:\> $security = New-DSGatewaySecurity -VaultRoleOverride All -DisallowDynamicConnections
PS C:\> Update-DSGateway -GatewayID $gatewayId -Security $security

Créer une configuration de sécurité qui donne des permissions sur tous les coffres et désactive les connexions dynamiques, puis l'appliquer à une passerelle.

Exemple 2

PS C:\> $vaultIds = @($vaultId1, $vaultId2)
PS C:\> $security = New-DSGatewaySecurity -VaultRoleOverride Custom -CustomVaultAccess $vaultIds -DisallowPrivateVaults
PS C:\> Update-DSGatewayRuleset -GatewayID $gatewayRulesetId -Security $security

Créer une configuration de sécurité dont l'accès est limité à des coffres précis, interdire les coffres privés et l'appliquer à un jeu de règles de passerelle.

Exemple 3

PS C:\> $principalIds = @($principalId1, $principalId2)
PS C:\> $security = New-DSGatewaySecurity -GatewayPermissionOverride Custom -CustomGatewayPermissions $principalIds -RDPTokenReuseWindow 5
PS C:\> New-DSGateway -Name 'MyGateway' -DevolutionsGatewayUrl 'https://gateway.example.com' -TCPListeningPort 8181 -Security $security

Créer une passerelle avec des permissions personnalisées pour des utilisateurs, des groupes d'utilisateurs ou des identités d’application précis et une fenêtre de réutilisation du jeton RDP de 5 minutes.

Paramètres

-CustomGatewayPermissions

Liste d'ID de principaux (utilisateurs, groupes d'utilisateurs ou identités d’application) lorsque GatewayPermissionOverride est défini à Custom. Utiliser le format Guid ou le format de chaîne Guid.

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

-CustomVaultAccess

Liste d'ID de coffres lorsque VaultRoleOverride est défini à Custom. Utiliser le format Guid ou le format de chaîne Guid.

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

-DisableRdpProxyCredentialInjection

Désactiver l'injection d'identifiants du proxy 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: ''

-DisallowDynamicConnections

Interdire les connexions dynamiques par la passerelle.

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: ''

-DisallowPrivateVaults

Interdire l'accès aux coffres privés.

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: ''

-DisallowRDPReconnection

Interdire la reconnexion RDP par la passerelle.

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: ''

-GatewayPermissionOverride

Mode de remplacement des permissions de passerelle (Default, Custom, Everyone, Never). La valeur Default est définie dans les paramètres système. Si Custom, spécifier les ID de principaux avec CustomGatewayPermissions.

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

-RDPTokenReuseWindow

Fenêtre de réutilisation du jeton RDP en minutes. Doit être un entier positif.

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

-VaultRoleOverride

Coffres auxquels la passerelle accorde l'accès (All, Custom, Never). Si Custom, spécifier les ID de coffre avec CustomVaultAccess.

Type: Devolutions.Server.Models.Shared.Models.Gateway.GatewayVaultRoleOverride
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Cette 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, consultez about_CommonParameters.

Sorties

Devolutions.Server.Models.Shared.Models.Gateway.GatewaySecurity

Notes

Pour plus d'information, tapez « Get-Help New-DSGatewaySecurity -detailed ». Pour de l'information technique, tapez « Get-Help New-DSGatewaySecurity -full ».