Search-DSEntry

Sinopsis

Buscar una entrada en la instancia de DVLS

Sintaxis

InputObject (predeterminado)

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

Buscar

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

Descripción

Buscar una entrada en la instancia de DVLS. Hay dos formas de ejecutar una búsqueda. Este cmdlet permite una búsqueda simple con un único criterio utilizando tres parámetros: By, Match y Value. Para una búsqueda más compleja o para mayor comodidad, se pueden crear criterios con el cmdlet New-DSSearchCriteria. El InputObject aceptará un array de dichos criterios. De forma predeterminada, se buscan todas las bóvedas, excepto la bóveda de usuario y las bóvedas PAM. Para esas dos bóvedas, cada una se incluirá utilizando el parámetro correspondiente: IncludeUserVault e IncludePAMVaults. También es posible buscar solo un subconjunto de bóvedas utilizando IncludeVault o ExcludeVault.

Ejemplos

Ejemplo 1

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

Buscar en las dos bóvedas identificadas por los ID almacenados en $pamvaultAID y $pamVaultBID una entrada cuyo nombre sea 'SomeValue'

Ejemplo 2

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

Buscar todas las entradas cuyo nombre comience por ThePrefix en todas las bóvedas, excluyendo la bóveda de usuario y las bóvedas PAM.

Ejemplo 3

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

Buscar todas las entradas PAM cuyo nombre de usuario contenga AUsername creadas en los últimos 30 días. Solo se buscarán las bóvedas PAM.

Ejemplo 4

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

Buscar todas las entradas PAM cuyo nombre de usuario contenga AUsername creadas en los últimos 30 días. Solo se buscarán las bóvedas PAM.

Parámetros

-AsLegacyResponse

En versiones anteriores a 2024.2, muchos cmdlets de DS devolvían un objeto ServerResponse. Habilitar este modificador de compatibilidad retroactiva permite que los scripts desarrollados para versiones anteriores funcionen correctamente.

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

Campo al que se aplicará la expresión

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

Bóvedas que se excluirán de la búsqueda.

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

Incluir las bóvedas 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

Incluir la bóveda de usuario

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

Bóvedas en las que se buscará. Si no se especifica, se buscará en todas ellas excepto en las bóvedas PAM y la bóveda de usuario. Para las bóvedas PAM o la bóveda de usuario, utilice el modificador correspondiente.

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

Criterios de búsqueda creados a 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: ''

-Match

Condición que debe respetar la expresión. De forma predeterminada, la condición es '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

Valor de cadena

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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, consulte about_CommonParameters.

Entradas

Devolutions.RemoteDesktopManager.Business.MultiVaultSearchItemData

Array de criterios creados por llamadas a New-DSSearchCriteria.

Notas

Para obtener más información, escriba "Get-Help Search-DSEntry -detailed". Para obtener información técnica, escriba "Get-Help Search-DSEntry -full".