New-DSGatewaySecurity

Übersicht

Ein neues GatewaySecurity-Objekt erstellen

Syntax

__AllParameterSets

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

Beschreibung

Ein neues GatewaySecurity-Objekt erstellen, mit dem Sicherheitseinstellungen beim Erstellen oder Aktualisieren von Gateways konfiguriert werden können. Diese Einstellungen können auch für Gateway-Regelsätze und Gateway-Farmen konfiguriert werden.

Beispiele

Beispiel 1

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

Eine Sicherheitskonfiguration erstellen, die Berechtigungen für alle Tresore erteilt und dynamische Verbindungen deaktiviert, und sie anschließend auf ein Gateway anwenden.

Beispiel 2

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

Eine Sicherheitskonfiguration mit auf bestimmte Tresore beschränktem Zugriff erstellen, private Tresore untersagen und sie auf einen Gateway-Regelsatz anwenden.

Beispiel 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

Ein Gateway mit benutzerdefinierten Berechtigungen für bestimmte Benutzer, Benutzergruppen oder Anwendungsidentitäten und einem 5-minütigen Fenster zur Wiederverwendung des RDP-Tokens erstellen.

Parameter

-CustomGatewayPermissions

Liste der Prinzipal-IDs (Benutzer, Benutzergruppen oder Anwendungsidentitäten), wenn GatewayPermissionOverride auf Custom festgelegt ist. Guid-Format oder Guid-Zeichenfolgenformat verwenden.

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 der Tresor-IDs, wenn VaultRoleOverride auf Custom festgelegt ist. Guid-Format oder Guid-Zeichenfolgenformat verwenden.

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

Einfügen von Anmeldeinformationen des RDP-Proxys deaktivieren.

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

Dynamische Verbindungen über das Gateway untersagen.

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

Zugriff auf private Tresore untersagen.

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

RDP-Wiederverbindung über das Gateway untersagen.

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

Überschreibungsmodus für Gateway-Berechtigungen (Default, Custom, Everyone, Never). Der Wert Default ist in den Systemeinstellungen definiert. Bei Custom die Prinzipal-IDs mit CustomGatewayPermissions angeben.

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

Fenster für die Wiederverwendung des RDP-Tokens in Minuten. Muss eine positive ganze Zahl sein.

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

Auf welche Tresore das Gateway Zugriff gewährt (All, Custom, Never). Bei Custom die Tresor-IDs mit CustomVaultAccess angeben.

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

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Ausgaben

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

Hinweise

Weitere Informationen erhalten Sie mit "Get-Help New-DSGatewaySecurity -detailed". Technische Informationen erhalten Sie mit "Get-Help New-DSGatewaySecurity -full".