> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell/fr/powershell-commands/search-dsentry.md).

# Search-DSEntry

Search-DSEntry recherche des entrées dans les coffres de Devolutions Server à l'aide d'un critère unique ou de critères de recherche complexes.

### Résumé

Rechercher une entrée dans l'instance DVLS

### Syntaxe

#### InputObject (par défaut)

```
Search-DSEntry [[-InputObject] <MultiVaultSearchItemData[]>] [-ExcludeVault <guid[]>]
 [-IncludeVault <guid[]>] [-IncludePAMVaults] [-IncludeUserVault] [-AsLegacyResponse]
 [<CommonParameters>]
```

#### Recherche

```
Search-DSEntry [-By] <SearchItemType> -Value <string> [-Match <SearchItemText>]
 [-ExcludeVault <guid[]>] [-IncludeVault <guid[]>] [-IncludePAMVaults] [-IncludeUserVault]
 [-AsLegacyResponse] [<CommonParameters>]
```

### Description

Rechercher une entrée dans l'instance DVLS. Il y a deux façons d'exécuter une recherche. Cette applet de commande permet une recherche simple avec un critère unique à l'aide de trois paramètres : By, Match et Value. Pour une recherche plus complexe ou pour plus de facilité d'utilisation, les critères peuvent être créés avec l'applet de commande New-DSSearchCriteria. L'InputObject accepte un tableau de ces critères. Par défaut, tous les coffres sont recherchés, sauf le coffre Utilisateur et les coffres de gestion des accès privilégiés. Pour ces deux coffres, chacun peut être inclus en utilisant le paramètre correspondant : IncludeUserVault et IncludePAMVaults. Il est aussi possible de rechercher seulement un sous-ensemble de coffres en utilisant IncludeVault ou ExcludeVault.

### Exemples

#### Exemple 1

```powershell
PS C:\> Search-DSEntry -By Name -Match ExactExpression -Value 'SomeValue' -IncludeVault @($pamVaultAID, $pamVaultBID)
```

Rechercher dans les deux coffres identifiés par les ID stockés dans $pamvaultAID et $pamVaultBID une entrée dont le nom est « SomeValue »

#### Exemple 2

```powershell
PS C:\> New-DSSearchCriteria -By Name -Match StartsWith -Value ThePrefix | Search-DSEntry
```

Rechercher toutes les entrées dont le nom commence par ThePrefix dans tous les coffres, en excluant le coffre Utilisateur et les coffres de gestion des accès privilégiés.

#### Exemple 3

```powershell
PS C:\> $criteria = @();
        $criteria += New-DSSearchCriteria -By Username -Value AUsername;
        $criteria += New-DSSearchCriteria -By CreationDate -Value Last30Days;
        Search-DSEntry -InputObject $criteria -IncludePamVaults -IncludeVault @()
```

Rechercher toutes les entrées de gestion des accès privilégiés dont le nom d'utilisateur contient AUsername créées au cours des 30 derniers jours. Seuls les coffres de gestion des accès privilégiés seront recherchés.

#### Exemple 4

```powershell
PS C:\> $criteria = @();
        $criteria += New-DSSearchCriteria -By Username -Value AUsername;
        $criteria += New-DSSearchCriteria -By CreationDate -Value Last30Days;
        Search-DSEntry -InputObject $criteria -IncludePamVaults -IncludeVault @()
```

Rechercher toutes les entrées de gestion des accès privilégiés dont le nom d'utilisateur contient AUsername créées au cours des 30 derniers jours. Seuls les coffres de gestion des accès privilégiés seront recherchés.

### Paramètres

#### -AsLegacyResponse

Dans les versions antérieures à 2024.2, plusieurs applets de commande DS retournaient un objet ServerResponse. L'activation de ce commutateur de compatibilité descendante permet aux scripts développés pour des versions antérieures de fonctionner correctement.

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

#### -By

Champ sur lequel l'expression sera appliquée

```yaml
Type: Devolutions.RemoteDesktopManager.SearchItemType
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Search
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

#### -ExcludeVault

Coffres à exclure de la recherche.

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

#### -IncludePAMVaults

Inclure les coffres de gestion des accès privilégiés

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

#### -IncludeUserVault

Inclure le coffre utilisateur

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

#### -IncludeVault

Coffres à rechercher. S'ils ne sont pas spécifiés, tous seront recherchés sauf les coffres de gestion des accès privilégiés et le coffre Utilisateur. Pour les coffres de gestion des accès privilégiés ou le coffre Utilisateur, utilisez le commutateur correspondant.

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

#### -InputObject

Critères de recherche créés à partir de New-DSSearchCriteria

```yaml
Type: Devolutions.RemoteDesktopManager.Business.MultiVaultSearchItemData[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: InputObject
  Position: 1
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

#### -Match

Condition que l'expression doit respecter. Par défaut, la condition est « Contains ».

```yaml
Type: Devolutions.RemoteDesktopManager.SearchItemText
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Search
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

#### -Value

Valeur de type chaîne

```yaml
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Search
  Position: Named
  IsRequired: true
  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'information, voir [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

### Entrées

#### Devolutions.RemoteDesktopManager.Business.MultiVaultSearchItemData

Tableau de critères créés par des appels à New-DSSearchCriteria.

### Notes

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell/fr/powershell-commands/search-dsentry.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.