Set-RDMEntryProperty

Synopsis

Définir la valeur d'une propriété d'une entrée

Syntaxe

__AllParameterSets

Set-RDMEntryProperty [-ID] <guid> [[-Path] <string>] [-Property] <string> [-Value] <Object>
 [-Refresh] [-VaultMode <VaultMode>] [-ForcePromptAnswer <DialogResult[]>] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Description

Définir la valeur d'une propriété d'une entrée. La propriété est spécifiée à l'aide des paramètres Path et Property. L'entrée est trouvée par son ID. Si le paramètre VaultMode n'est pas utilisé, les trois coffres (le coffre actuel, le coffre de l'utilisateur et le coffre global) seront parcourus. L'utilisateur doit avoir le droit de modifier l'entrée.

Exemples

Exemple 1

PS C:\> Set-RDMEntryProperty -ID "{00000000-0000-0000-0000-000000000000}" -Property "Group" -Value "My New Group Name"

Définir la valeur Group de l'entrée dont l'ID = "{00000000-0000-0000-0000-000000000000}".

Exemple 2

PS C:\> Set-RDMSessionProperty -ID "{00000000-0000-0000-0000-000000000000}" -Path "MetaInformation" -Property "OS" -Value "Windows Server 2008 R2"

Définir la valeur MetaInformation.OS de la session dont l'ID = "{00000000-0000-0000-0000-000000000000}".

Paramètres

-Confirm

Vous invite à confirmer avant d'exécuter la cmdlet.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ForcePromptAnswer

Paramètre à utiliser avec prudence. Il répondra automatiquement aux invites demandant des questions oui/non, oui/non/annuler ou ok/annuler. En cas de plusieurs invites, plusieurs valeurs peuvent être passées à ce paramètre. Voici les valeurs acceptées :

• Yes : Accepter l'invite. Couvre les valeurs OK et Automatic.
• No : Refuser l'invite oui/non/annuler. « Cancel » est l'option de secours s'il n'y a pas d'option « No ».
• Cancel : Annuler l'invite oui/non/annuler. « No » est l'option de secours s'il n'y a pas d'option « Cancel ».

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

-ID

Spécifie l'ID de l'entrée pour laquelle définir la propriété. Doit être un GUID valide, sous la forme {00000000-0000-0000-0000-000000000000}.

Type: System.Guid
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é à définir (référencer le XML d'exportation RDM). Dans le cas d'une propriété de niveau supérieur, ne pas spécifier le paramètre ou passer une chaîne vide [""] ou $null.

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

-Property

Propriété à définir.

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

-Refresh

Actualiser les entrées dans le coffre. Toutes les entrées de type « Group » déclenchent automatiquement une actualisation pour s'assurer qu'elles sont disponibles pour les autres entrées. Pour des modifications en masse, utilisez Update-RDMEntries après les modifications plutôt que ce paramètre.

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

-Value

Nouvelle valeur.

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

-VaultMode

Coffre auquel la commande sera appliquée. Trois choix sont proposés :

• Default : Coffre actuel qui a été défini.
• User : Coffre spécifique à l'utilisateur actuel.
• Global : Coffre global de l'espace de travail.

Type: Devolutions.RemoteDesktopManager.VaultMode
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Affiche ce qui se passerait si la cmdlet s'exécutait. La cmdlet n'est pas exécutée.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  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.

Notes

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