Get-DSEntry

Synopsis

Obtenir une ou plusieurs entrées de votre instance Devolutions Server.

Syntaxe

GetAll (Default)

Get-DSEntry [[-VaultID] <guid>] [-All] [-SearchAllVaults] [-AsLegacyResponse] [<CommonParameters>]

GetById

Get-DSEntry [[-VaultID] <guid>] [-EntryId] <guid> [[-VaultPassword] <string>] [-AsRDMConnection]
 [-SearchAllVaults] [-AsLegacyResponse] [<CommonParameters>]

Filter

Get-DSEntry [[-VaultID] <guid>] [-FilterValue] <string> [[-FilterBy] <SearchItemType>]
 [[-FilterMatch] <SearchItemText>] [-SearchAllVaults] [-AsLegacyResponse] [<CommonParameters>]

GetPage

Get-DSEntry [[-VaultID] <guid>] [[-PageSize] <int>] [[-PageNumber] <int>] [[-FolderID] <guid>]
 [-SearchAllVaults] [-AsLegacyResponse] [<CommonParameters>]

Description

En utilisant différents ensembles de paramètres, retourne soit toutes les entrées (d'un ou de tous les coffres), une entrée spécifique par filtre (Get-Help Get-DSEntry -Parameter FilterBy) ou des résultats paginés.

Exemples

Exemple 1

PS C:\> Get-DSEntry

Obtenir la première page contenant 25 entrées directement à la racine du coffre par défaut.

Exemple 2

PS C:\> Get-DSEntry -SearchAllVaults -EntryId $entryId -AsRDMConnection

Obtenir l'entrée par son identifiant. La recherche couvre tous les coffres.

Exemple 3

PS C:\> Get-DSEntry -VaultID $vaultID -All

Obtenir toutes les entrées du coffre spécifié.

Exemple 4

PS C:\> Get-DSEntry -Filter Name -FilterMatch StartsWith -FilterValue ABC -SearchAllVaults

Obtenir toutes les entrées dont le nom commence par « ABC » dans tous les coffres.

Paramètres

-All

Obtenir toutes les entrées.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: GetAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

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

-AsRDMConnection

Retourner un ConnectionInfoEntity au lieu d'une connexion partielle.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: GetById
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-EntryId

Identifiant de l'entrée souhaitée.

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: GetById
  Position: 1
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-FilterBy

Champ sur lequel le filtre sera appliqué. Par défaut, il s'applique au nom.

Type: Devolutions.RemoteDesktopManager.SearchItemType
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Filter
  Position: 2
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-FilterMatch

Détermine la condition de la recherche. La condition par défaut est Contient.

Type: Devolutions.RemoteDesktopManager.SearchItemText
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Filter
  Position: 3
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-FilterValue

Valeur utilisée dans le filtre.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Filter
  Position: 1
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-FolderID

Dossier depuis lequel les entrées seront récupérées. La valeur par défaut est la racine.

Type: System.Nullable`1[System.Guid]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: GetPage
  Position: 3
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PageNumber

Détermine quelle page est récupérée.

Type: System.Int32
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: GetPage
  Position: 2
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PageSize

Nombre d'entrées par page. La valeur par défaut est 25 entrées par page.

Type: System.Int32
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: GetPage
  Position: 1
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SearchAllVaults

Tous les coffres seront pris en compte pour la recherche.

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

-VaultID

Identifiant du coffre dans lequel effectuer la recherche.

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-VaultPassword

Mot de passe du coffre.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: GetById
  Position: 2
  IsRequired: false
  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.

Notes

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