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

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

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

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

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.

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

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.

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

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

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.

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

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

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

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.

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".