> 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/de/powershell-commands/search-dsentry.md).

# Search-DSEntry

### Übersicht

Einen Eintrag in der DVLS-Instanz suchen

### Syntax

#### InputObject (Standard)

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

#### Suche

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

### Beschreibung

Einen Eintrag in der DVLS-Instanz suchen. Es gibt zwei Möglichkeiten, eine Suche auszuführen. Dieses Cmdlet ermöglicht eine einfache Suche mit einem einzelnen Kriterium unter Verwendung von drei Parametern: By, Match und Value. Für eine komplexere Suche oder zur einfacheren Handhabung können Kriterien mit dem Cmdlet New-DSSearchCriteria erstellt werden. Das InputObject akzeptiert ein Array dieser Kriterien. Standardmäßig werden alle Tresore durchsucht, außer dem Benutzer-Tresor und den PAM-Tresoren. Diese beiden Tresore werden jeweils durch Verwendung des entsprechenden Parameters einbezogen: IncludeUserVault und IncludePAMVaults. Es ist außerdem möglich, nur eine Teilmenge der Tresore zu durchsuchen, indem einer der Parameter IncludeVault und ExcludeVault verwendet wird.

### Beispiele

#### Beispiel 1

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

In den beiden Tresoren, die durch die in $pamvaultAID und $pamVaultBID gespeicherten IDs identifiziert werden, nach einem Eintrag mit dem Namen 'SomeValue' suchen

#### Beispiel 2

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

Alle Einträge, deren Name mit ThePrefix beginnt, in allen Tresoren suchen, ausgenommen der Benutzer-Tresor und die PAM-Tresore.

#### Beispiel 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 @()
```

Alle PAM-Einträge suchen, deren Benutzername AUsername enthält und die in den letzten 30 Tagen erstellt wurden. Nur die PAM-Tresore werden durchsucht.

#### Beispiel 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 @()
```

Alle PAM-Einträge suchen, deren Benutzername AUsername enthält und die in den letzten 30 Tagen erstellt wurden. Nur die PAM-Tresore werden durchsucht.

### Parameter

#### -AsLegacyResponse

In Versionen vor 2024.2 gaben viele DS-Cmdlets ein ServerResponse-Objekt zurück. Durch Aktivieren dieses Schalters für Rückwärtskompatibilität funktionieren Skripte, die für frühere Versionen entwickelt wurden, weiterhin korrekt.

```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

Feld, auf das der Ausdruck angewendet wird

```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

Tresore, die von der Suche ausgeschlossen werden sollen.

```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

Die PAM-Tresore einbeziehen

```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

Den Benutzer-Tresor einbeziehen

```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

Zu durchsuchende Tresore. Wenn nicht angegeben, werden alle durchsucht, außer den PAM-Tresoren und dem Benutzer-Tresor. Für die PAM-Tresore oder den Benutzer-Tresor verwenden Sie den entsprechenden Schalter.

```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

Mit New-DSSearchCriteria erstellte Suchkriterien

```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

Bedingung, die der Ausdruck erfüllen muss. Standardmäßig ist die Bedingung '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

Zeichenfolgenwert

```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

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

### Eingaben

#### Devolutions.RemoteDesktopManager.Business.MultiVaultSearchItemData

Array von Kriterien, die durch Aufrufe von New-DSSearchCriteria erstellt wurden.

### Hinweise

Weitere Informationen erhalten Sie mit "Get-Help Search-DSEntry -detailed". Technische Informationen erhalten Sie mit "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/de/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.