Set-RDMEntryTags

Synopsis

Définir les étiquettes d'une entrée

Syntaxe

ID

Set-RDMEntryTags [-ID] <guid> [-Tags] <string[]> [-PassThru] [-Refresh] [-Set]
 [-VaultMode <VaultMode>] [-ForcePromptAnswer <DialogResult[]>] [-WhatIf] [-Confirm]
 [<CommonParameters>]

InputObject

Set-RDMEntryTags [-InputObject] <PSConnection> [-Tags] <string[]> [-PassThru] [-Refresh] [-Set]
 [-VaultMode <VaultMode>] [-ForcePromptAnswer <DialogResult[]>] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Description

Définit les étiquettes de l'entrée spécifiée à partir d'un tableau. Ceci remplace toutes les étiquettes existantes de l'entrée (les étiquettes héritées ne sont pas touchées). Pour conserver les nouvelles étiquettes lors de l'utilisation du jeu de paramètres InputObject, le commutateur Set doit être utilisé. Lors de l'utilisation du jeu de paramètres ID, l'entrée est enregistrée automatiquement. L'utilisateur doit avoir le droit de modifier l'entrée. L'héritage des étiquettes peut être activé au niveau du coffre en modifiant l'objet de connexion racine.

Exemples

Exemple 1

PS C:\> Set-RDMEntryTags -ID "{00000000-0000-0000-0000-000000000000}" -Tags @("Production", "Database", "Critical")

Définir les étiquettes d'une entrée à l'aide de son ID.

Exemple 2

PS C:\> $entry = Get-RDMEntry -Name 'MyEntry';
PS C:\> Set-RDMEntryTags -InputObject $entry -Tags @("Production", "Database", "Critical") -Set

Définir les étiquettes d'une entrée avec InputObject et enregistrer les changements.

Exemple 3

PS C:\> Get-RDMEntry -Name "MyEntry" | Set-RDMEntryTags -Tags @("Production", "Database") -PassThru

Utilisation du pipeline avec InputObject et PassThru pour retourner l'entrée modifiée.

Exemple 4

PS C:\> Set-RDMEntryTags -ID "{00000000-0000-0000-0000-000000000000}" -Tags @()

Effacer toutes les étiquettes d'une entrée.

Exemple 5

PS C:\> $tags = Get-RDMEntryTags -ID "{00000000-0000-0000-0000-000000000000}"
PS C:\> $tags += "NewTag"
PS C:\> Set-RDMEntryTags -ID "{00000000-0000-0000-0000-000000000000}" -Tags $tags

Obtenir, modifier et définir les étiquettes d'une entrée.

Exemple 6

PS C:\> Get-RDMEntry -Name "MyEntry" |
Set-RDMEntryTags -Tags @("Production", "Database") -PassThru |
Set-RDMEntryDomain -Domain "MyDomain.com" -PassThru |
Set-RDMEntry

Enchaîner plusieurs modifications au moyen de PassThru et enregistrer avec Set-RDMEntry.

Paramètres

-Confirm

Demande une confirmation avant d'exécuter l'applet de commande.

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

Commutateur à utiliser avec prudence. Il répondra automatiquement aux invites posant des questions oui/non, oui/non/annuler ou ok/annuler. En cas d'invites multiples, 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 repli s'il n'y a pas d'option « No ».
• Cancel : Annuler l'invite oui/non/annuler. « No » est l'option de repli 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 sur laquelle définir les étiquettes. Doit être un GUID valide, de la forme {00000000-0000-0000-0000-000000000000}.

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ID
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Spécifie l'entrée sur laquelle définir les étiquettes.

Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: InputObject
  Position: 0
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Retourner l'entrée modifiée.

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

-Refresh

Actualiser les entrées dans le coffre. Utiliser le commutateur Set pour conserver la modification. Pour une modification en lot, utiliser Update-RDMEntries après les modifications au lieu de ce commutateur.

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

-Set

Enregistrer l'entrée modifiée.

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

-Tags

Tableau d'étiquettes à définir sur l'entrée. Passer un tableau vide pour effacer toutes les étiquettes.

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

-VaultMode

Coffre dans lequel la commande sera appliquée. Trois choix sont offerts : - 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

Montre ce qui se passerait si l'applet de commande était exécutée. L'applet de commande 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 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, consultez about_CommonParameters.

Entrées

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection

Objet PSConnection de l'entrée sur laquelle définir les étiquettes.

Sorties

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection

L'entrée avec les étiquettes nouvellement attribuées est retournée lorsque PassThru est utilisé.

Notes

Pour plus d'information, tapez « Get-Help Set-RDMEntryTags -detailed ». Pour de l'information technique, tapez « Get-Help Set-RDMEntryTags -full ».