Update-DSGateway

Sinopsis

Actualizar un gateway

Sintaxis

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>]

Descripción

Actualizar un gateway. Utilice los parámetros para modificar el gateway. Se requiere el módulo Devolutions Gateway.

Ejemplos

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

Actualice el gateway denominado "Old default gateway" eliminando su estado predeterminado. Una nueva descripción indicará el cambio.

Parámetros

-AsLegacyResponse

En las versiones anteriores a 2024.2, muchos cmdlets de DS devolvían un objeto ServerResponse. Habilitar este modificador de compatibilidad con versiones anteriores permite que los scripts desarrollados para versiones anteriores funcionen correctamente.

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

Lista de roles de acceso a bóvedas.

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

Descripción del 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: ''

-DevolutionsGatewayUrl

URL para acceder a Devolutions Gateway. Debe ser un URI válido y exclusivo de este 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: ''

-ForceIpAddressForRdpConnections

Forzar el uso de la dirección IP para las conexiones RDP.

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 del gateway que se va a actualizar.

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

Intervalo de comprobación de estado en minutos.

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

Establecer como gateway predeterminado

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

Nombre del gateway. Se recortará el valor.

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

Puerto utilizado para las sesiones RDP y, eventualmente, las sesiones SSH.

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

Duración del token generado en minutos. Debe estar entre 1 y 120 minutos.

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

A qué bóvedas concede acceso el gateway (si es personalizado, especifíquelo con 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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Notas

Para más información, escriba "Get-Help Update-DSGateway -detailed". Para obtener información técnica, escriba "Get-Help Update-DSGateway -full".