Update-DSGateway

Übersicht

Ein Gateway aktualisieren

Syntax

GetByID

Update-DSGateway -GatewayID <guid> [-Name <string>] [-Description <string>] [-IsDefault <bool>]
 [-DevolutionsGatewayUrl <string>] [-TCPListeningPort <int>] [-TokenDuration <int>]
 [-HealthCheckInterval <int>] [-ForceIpAddressForRdpConnections <bool>]
 [-VaultRoleOverride <GatewayVaultRoleOverride>] [-CustomVaultAccess <guid[]>] [-AsLegacyResponse]
 [<CommonParameters>]

Beschreibung

Ein Gateway aktualisieren. Verwenden Sie die Parameter, um das Gateway zu ändern. Das Devolutions Gateway-Modul ist erforderlich.

Beispiele

PS C:\> $response = Get-DSGateway -Name "Old default gateway" -AsLegacyResponse;
        $gateway = $response.Data[0];
        Update-DSGateway -Name "Standard Gateway" -Description "Not the default anymore" -IsDefault $false

Aktualisieren Sie das Gateway mit dem Namen "Old default gateway", indem Sie seinen Standardstatus entfernen. Eine neue Beschreibung weist auf die Änderung hin.

Parameter

-AsLegacyResponse

In Versionen vor 2024.2 gaben viele DS-Cmdlets ein ServerResponse-Objekt zurück. Durch Aktivieren dieses Schalters zur Rückwärtskompatibilität können für frühere Versionen entwickelte Skripte korrekt funktionieren.

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

-CustomVaultAccess

Liste der Tresor-Zugriffsrollen.

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

-Description

Beschreibung des Gateways

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

-DevolutionsGatewayUrl

URL zum Erreichen des Devolutions Gateway. Muss eine gültige URI und für dieses Gateway eindeutig sein.

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

-ForceIpAddressForRdpConnections

Verwendung der IP-Adresse für RDP-Verbindungen erzwingen.

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

-GatewayID

ID des zu aktualisierenden Gateways.

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

-HealthCheckInterval

Intervall der Statusprüfung in Minuten.

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

-IsDefault

Als Standard-Gateway festlegen

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

-Name

Name des Gateways. Der Wert wird gekürzt.

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

-TCPListeningPort

Port, der für RDP-Sitzungen und eventuell für SSH-Sitzungen verwendet wird.

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

-TokenDuration

Dauer des generierten Tokens in Minuten. Muss zwischen 1 und 120 Minuten liegen.

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 (bei "custom" 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.

Hinweise

Weitere Informationen erhalten Sie mit "Get-Help Update-DSGateway -detailed". Technische Informationen erhalten Sie mit "Get-Help Update-DSGateway -full".