Set-DSEntryProperty

Synopsis

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

Syntaxe

__AllParameterSets

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

Description

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 ; utilisez Update-DSEntryBase -FromRDMConnection pour conserver les modifications. Cette cmdlet permet des mises à jour de propriétés basées sur le pipeline, autorisant plusieurs modifications de propriétés avant l'enregistrement.

Exemples

Exemple 1

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-identifiants ; pour les entrées d'identifiants, voir l'exemple suivant.

Exemple 2

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'identifiants.

Exemple 3

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 entre guillemets.

Exemple 4

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 » sur chacune.

Exemple 5

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 l'enregistrement : renommer, changer l'hôte, déplacer vers un dossier, définir sa description et ses identifiants.

Exemple 6

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 brut, tandis que CustomField[1-5]ValueSensitive chiffre automatiquement les valeurs lors de l'enregistrement. Définissez CustomField[1-5]Hidden à true pour marquer les champs chiffrés comme sensibles dans l'interface.

Exemple 7

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 brut en définissant CustomField[1-5]Hidden à false et en définissant CustomField[1-5]Value. La valeur sensible est automatiquement effacée.

Paramètres

-Entry

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

-Path

Le chemin vers la propriété (par exemple, « MetaInformation »). Laissez 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: ''

-PropertyName

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

-PropertyValue

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

CommonParameters

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

Entrées

Devolutions.RemoteDesktopManager.Business.Entities.ConnectionInfoEntity

Informations de connexion de l'entrée.

Sortie

Devolutions.RemoteDesktopManager.Business.Entities.ConnectionInfoEntity

Notes

Pour plus d'informations, tapez « Get-Help Set-DSEntryProperty -detailed ». Pour les informations techniques, tapez « Get-Help Set-DSEntryProperty -full ».