Search-DSEntry

Rechercher une entrée dans l'instance DVLS

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

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

Rechercher une entrée dans l'instance DVLS. Il y a deux façons d'exécuter une recherche. Cet applet de commande permet une recherche simple avec un seul critère en utilisant trois paramètres : By, Match, et Value. Pour une recherche plus complexe ou une facilité d'utilisation, les critères peuvent être créés avec l'applet de commande New-DSSearchCriteria. L'InputObject acceptera un tableau de ces critères. Par défaut, tous les coffres sont recherchés, à l'exception du coffre de l'utilisateur et des PAM coffres. Pour ces deux coffres, chacun sera inclus en utilisant le paramètre correspondant : IncludeUserVault et IncludePAMVaults. Il est également possible de ne rechercher qu'un sous-ensemble de coffres en utilisant l'un des IncludeVault et ExcludeVault.

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 pour une entrée dont le nom est 'SomeValue'

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 de l'utilisateur et des PAM coffres.

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 créé au cours des 30 derniers jours. Seulement les coffres PAM seront recherchés.

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 créé au cours des 30 derniers jours. Seulement les coffres PAM seront recherchés.

Dans les versions antérieures à 2024.2, de nombreux DS applets de commande renvoyaient un objet ServerResponse. Activer ce commutateur de compatibilité rétroactive 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: ''

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

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

Inclure les PAM coffres

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

Inclure le coffre de l'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: ''

Coffres à rechercher. Si non spécifié, tous seront recherchés, sauf les PAM coffres et le coffre de l'utilisateur. Pour les PAM coffres ou le coffre de l'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: ''

Critères de recherche créés à partir de 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: ''

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

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

Cet applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. Pour plus d'informations, voir about_CommonParameters.

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

Pour plus d'informations, taper "Get-Help Search-DSEntry -detailed". Pour des informations techniques, taper "Get-Help Search-DSEntry -full".