Set-DSEntryProperty

Définir une propriété sur une entrée. L'entrée n'est pas enregistrée sur le serveur.

Set-DSEntryProperty [-Entry] <ConnectionInfoEntity> [[-Path] <string>] [-PropertyName] <string>
 [-PropertyValue] <Object> [<CommonParameters>]

Définir une propriété sur une entrée et retourner l'objet modifié. L'entrée n'est pas enregistrée sur le serveur ; utiliser Update-DSEntryBase -FromRDMConnection pour persister les modifications. Cette applet de commande permet des mises à jour de propriété basées sur un pipeline, permettant plusieurs modifications de propriété avant l'enregistrement.

PS C:\> $entry = Get-DSEntry -EntryID "{00000000-0000-0000-0000-000000000000}" -AsRDMConnection
PS C:\> $entry.ConnectionInfo | Set-DSEntryProperty -PropertyName "HostPassword" -PropertyValue "MyNewPassword" | Update-DSEntryBase

Obtenir une entrée, définir son mot de passe, et l'enregistrer sur le serveur. Ceci est destiné aux entrées non-crédentialisées ; pour les entrées crédentialisées, voir l'exemple suivant.

PS C:\> $entry = Get-DSEntry -EntryID "{00000000-0000-0000-0000-000000000000}" -AsRDMConnection
PS C:\> $entry.ConnectionInfo | Set-DSEntryProperty -Path "Credentials" -PropertyName "Password" -PropertyValue "MyNewPassword" | Update-DSEntryBase

Définir le mot de passe d'une entrée d'identifiant.

PS C:\> $entry = Get-DSEntry -EntryID "{00000000-0000-0000-0000-000000000000}" -AsRDMConnection
PS C:\> $entry.ConnectionInfo | Set-DSEntryProperty -Path "MetaInformation" -PropertyName "Keywords" -PropertyValue "production web-server critical" | Update-DSEntryBase

Définir des étiquettes sur une entrée en utilisant le chemin MetaInformation. Les étiquettes sont séparées par des espaces. Les étiquettes contenant des espaces doivent être citées.

PS C:\> Get-DSEntry -FilterBy Name -FilterMatch StartsWith -FilterValue "Prod" -SearchAllVaults |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "Keywords" -PropertyValue "production" |
    Update-DSEntryBase

Obtenir les entrées dont le nom commence par 'Prod' dans tous les coffres et définir l'étiquette 'production' pour chaque.

PS C:\> $entry = Get-DSEntry -EntryID "{00000000-0000-0000-0000-000000000000}" -AsRDMConnection
PS C:\> $entry.ConnectionInfo |
    Set-DSEntryProperty -PropertyName "Name" -PropertyValue "Production Server" |
    Set-DSEntryProperty -PropertyName "Host" -PropertyValue "server.windjammer.loc" |
    Set-DSEntryProperty -PropertyName "Group" -PropertyValue "Production\Servers\Web" |
    Set-DSEntryProperty -PropertyName "Description" -PropertyValue "Production web server" |
    Set-DSEntryProperty -PropertyName "HostUserName" -PropertyValue "admin" |
    Set-DSEntryProperty -PropertyName "HostDomain" -PropertyValue "WINDJAMMER" |
    Set-DSEntryProperty -PropertyName "HostPassword" -PropertyValue "SecurePass123" |
    Update-DSEntryBase

Enchaîner plusieurs mises à jour de propriétés dans un pipeline avant de sauvegarder : renommer, changer l'hôte, déplacer vers un dossier, définir sa description et ses informations d'identification.

PS C:\> $entry = Get-DSEntry -EntryID "{00000000-0000-0000-0000-000000000000}" -AsRDMConnection
PS C:\> $entry.ConnectionInfo |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField1Title" -PropertyValue "Department" |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField1Value" -PropertyValue "Engineering" |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField2Title" -PropertyValue "API Key" |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField2ValueSensitive" -PropertyValue "sk-abc123def456" |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField2Hidden" -PropertyValue $true |
    Update-DSEntryBase

Définir des champs personnalisés sur une entrée. CustomField[1-5]Value stocke du texte en clair, tandis que CustomField[1-5]ValueSensitive crypte automatiquement les valeurs lorsqu'enregistrées. Définir CustomField[1-5]Hidden à true pour marquer les champs chiffrés comme sensibles dans l'interface utilisateur.

PS C:\> $entry = Get-DSEntry -EntryID "{00000000-0000-0000-0000-000000000000}" -AsRDMConnection
PS C:\> $entry.ConnectionInfo |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField1Hidden" -PropertyValue $false |
    Set-DSEntryProperty -Path "MetaInformation" -PropertyName "CustomField1Value" -PropertyValue "plain text value" |
    Update-DSEntryBase

Convertir un champ personnalisé sensible en texte en clair en définissant CustomField[1-5]Hidden à false et en définissant CustomField[1-5]Value. La valeur sensible est automatiquement effacée.

L'entrée à modifier.

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

Le chemin de la propriété (par exemple, 'MetaInformation'). Laisser vide pour les propriétés de niveau supérieur. Ce paramètre est sensible à la casse.

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

Le nom de la propriété à définir (par exemple, 'HostUserName', 'HostPassword', 'Description'). Ce paramètre est sensible à la casse.

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

La nouvelle valeur pour la propriété.

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

Cette applet de commande prend en charge les paramètres communs: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, et -WarningVariable. Pour plus d'informations, voir about_CommonParameters.

Informations de connexion d'entrée.

Pour plus d'informations, taper "Get-Help Set-DSEntryProperty -detailed". Pour des informations techniques, taper "Get-Help Set-DSEntryProperty -full".