Update-DSGateway

Sintesi

Aggiorna un gateway

Sintassi

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

Descrizione

Aggiorna un gateway. Utilizzi i parametri per modificare il gateway. È richiesto il modulo Devolutions Gateway.

Esempi

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

Aggiorna il gateway denominato "Old default gateway" rimuovendone lo stato di predefinito. Una nuova descrizione indicherà la modifica.

Parametri

-AsLegacyResponse

Nelle versioni precedenti alla 2024.2, molti cmdlet DS restituivano un oggetto ServerResponse. L'abilitazione di questo switch di compatibilità con le versioni precedenti consente il corretto funzionamento degli script sviluppati per le versioni precedenti.

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

Elenco dei ruoli di accesso alla cassaforte.

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

Descrizione 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 per raggiungere il Devolutions Gateway. Deve essere un URI valido e univoco per questo 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

Forza l'utilizzo dell'indirizzo IP per le connessioni 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 da aggiornare.

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

Intervallo di controllo dello stato in minuti.

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

Imposta come gateway predefinito

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

Nome del gateway. Il valore verrà troncato degli spazi.

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

Porta utilizzata per le sessioni RDP ed eventualmente per le sessioni 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

Durata del token generato in minuti. Deve essere compresa tra 1 e 120 minuti.

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 quali casseforti il gateway concede l'accesso (se personalizzato, lo specifichi 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

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per maggiori informazioni, consulti about_CommonParameters.

Note

Per maggiori informazioni, digiti "Get-Help Update-DSGateway -detailed". Per informazioni tecniche, digiti "Get-Help Update-DSGateway -full".