Update-DSEntryBase

Übersicht

Einen Eintrag aktualisieren.

Syntax

Wert

Update-DSEntryBase [-JsonBody] <string> [-AsLegacyResponse] [<CommonParameters>]

RDMConnection

Update-DSEntryBase [-FromRDMConnection] <ConnectionInfoEntity> [-AsLegacyResponse]
 [<CommonParameters>]

Beschreibung

Einen Eintrag aktualisieren (der geänderte Eintrag sollte sich in jsonBody befinden). Sofern Sie nicht genau wissen, was Sie tun, sollten Sie wahrscheinlich die von uns erstellten CMDlets verwenden, um Einträge zu aktualisieren.

Beispiele

Beispiel 1

PS C:\> $credResponse = Get-DSEntry -EntryID $id
        $cred = $credResponse.data
        $cred.data.passwordItem | Add-Member -MemberType NoteProperty -Name SensitiveData -Value 'newPassword'
        Update-DSEntryBase -JsonBody (ConvertTo-Json -InputObject $cred -Depth 4)

Ein bestehender Eintrag für Anmeldeinformationen mit einem bestehenden Passwort wird abgerufen. Sein Passwort wird auf 'newPassword' geändert, indem eine Eigenschaft für sensible Daten zu passwordItem hinzugefügt wird. Der Eintrag wird mit der erforderlichen Tiefe in JSON konvertiert, um ein Abflachen zu vermeiden. Der Eintrag wird anschließend aktualisiert.

Beispiel 2

PS C:\> $credResponse = Get-DSEntry -EntryID $id
        $cred = $credResponse.data
        $cred.data.passwordItem | Add-Member -MemberType NoteProperty -Name SensitiveData -Value 'newPassword'
        Update-DSEntryBase -JsonBody (ConvertTo-Json -InputObject $cred -Depth 4)

Ein bestehender Eintrag für Anmeldeinformationen mit einem bestehenden Passwort wird abgerufen. Sein Passwort wird auf 'newPassword' geändert, indem eine Eigenschaft für sensible Daten zu passwordItem hinzugefügt wird. Der Eintrag wird mit der erforderlichen Tiefe in JSON konvertiert, um ein Abflachen zu vermeiden. Der Eintrag wird anschließend aktualisiert.

Beispiel 3

PS C:\> $entryID = '12345678-1234-1234-1234-123456781234'
PS C:\> $entry = Get-DSEntry -EntryID $entryID
PS C:\> $entry.data.vpn = @{                                                       
  application = [Devolutions.RemoteDesktopManager.VPNApplication]::DevolutionsGateway
  closeMode = [Devolutions.RemoteDesktopManager.VPNCloseMode]::OnDisconnect
  devolutionsGatewayID = '6ccf937c-7a98-4106-b951-815471ec649b'
  mode = [Devolutions.RemoteDesktopManager.VPNMode]::AlwaysConnect
  enableAutoDetectIsOnlineVPN = 2
}
PS C:\> Update-DSEntryBase -JsonBody (ConvertTo-Json -InputObject $entry -Depth 10)

Legen Sie das Standard-Devolutions Gateway für den Eintrag mit dem Verbindungsmodus 'Always Connect' und dem Schließmodus 'On session close' fest

Parameter

-AsLegacyResponse

In Versionen vor 2024.2 gaben viele DS-Cmdlets ein ServerResponse-Objekt zurück. Durch Aktivieren dieses Schalters für Rückwärtskompatibilität können Skripte, die für frühere Versionen entwickelt wurden, 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: ''

-FromRDMConnection

Eintrag, der von Get-DSEntry -AsRDMConnection abgerufen wurde. Er kann verwendet werden, um einen Eintrag zu aktualisieren

Type: Devolutions.RemoteDesktopManager.Business.Entities.ConnectionInfoEntity
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: RDMConnection
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-JsonBody

Eintrag in JSON

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Value
  Position: 0
  IsRequired: true
  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-DSEntryBase -detailed". Technische Informationen erhalten Sie mit "Get-Help Update-DSEntryBase -full".