Search-DSEntry

Synopsis

Rechercher une entrée dans l'instance DVLS

Syntaxe

InputObject (Default)

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

Search

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 existe deux façons d'effectuer une recherche. Cette cmdlet permet une recherche simple avec un seul critère à l'aide de trois paramètres : By, Match et Value. Pour une recherche plus complexe ou pour faciliter l'utilisation, des critères peuvent être créés avec la cmdlet New-DSSearchCriteria. L'InputObject accepte un tableau de ces critères. Par défaut, tous les coffres sont inclus dans la recherche, à l'exception du coffre utilisateur et des coffres PAM. Pour ces deux coffres, chacun peut être inclus en utilisant le paramètre correspondant : IncludeUserVault et IncludePAMVaults. Il est également possible de rechercher uniquement un sous-ensemble de coffres en utilisant l'un des paramètres IncludeVault ou ExcludeVault.

Exemples

Exemple 1

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

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

Exemple 2

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, à l'exclusion du coffre utilisateur et des coffres PAM.

Exemple 3

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 PAM dont le nom d'utilisateur contient AUsername et qui ont été créées au cours des 30 derniers jours. Seuls les coffres PAM seront inclus dans la recherche.

Exemple 4

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 PAM dont le nom d'utilisateur contient AUsername et qui ont été créées au cours des 30 derniers jours. Seuls les coffres PAM seront inclus dans la recherche.

Paramètres

-AsLegacyResponse

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

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

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.

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 PAM

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

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 dans lesquels effectuer la recherche. Si ce paramètre n'est pas spécifié, tous les coffres seront inclus, à l'exception des coffres PAM et du coffre utilisateur. Pour les coffres PAM ou le coffre utilisateur, utilisez le commutateur correspondant.

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 d'appels à New-DSSearchCriteria

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

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

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

Entrées

Devolutions.RemoteDesktopManager.Business.MultiVaultSearchItemData

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

Notes

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