Get-DSPamAccount

Synopsis

Récupérer des comptes PAM.

Syntaxe

GetByFolder (Default)

Get-DSPamAccount [-VaultID <guid>] [-AddActiveCheckoutID] [-IncludeDomainName] [-AsLegacyResponse]
 [<CommonParameters>]

GetByID

Get-DSPamAccount -AccountID <guid> [-AddActiveCheckoutID] [-IncludeDomainName] [-AsLegacyResponse]
 [<CommonParameters>]

BasicInformation

Get-DSPamAccount -AsBasicInformation [-VaultID <guid>] [-AsLegacyResponse] [<CommonParameters>]

Description

Récupérer des comptes PAM. Il existe trois façons de procéder. Premièrement, obtenir un compte spécifique en utilisant le paramètre AccountID. Deuxièmement, obtenir tous les comptes PAM en appelant la cmdlet sans paramètres. Troisièmement, obtenir tous les comptes PAM d'un dossier spécifique en utilisant le paramètre FolderID. Dans le cas où il y a un grand nombre de comptes PAM, il est possible qu'une exception TryGoOfflineException se produise. Le cas échéant, il existe deux façons d'éviter cette erreur. Premièrement, lors de l'appel de New-DSSession, utiliser le paramètre Timeout pour augmenter le délai d'interrogation. Une autre façon est d'utiliser le commutateur AsBasicInformation de cette cmdlet. Cela retournera un objet simplifié avec les informations permettant d'identifier rapidement les comptes PAM d'intérêt.

Exemples

Exemple 1

PS C:\> $searchRes = Search-DSEntry -By Username -Match ExactExpression -Value 'MyUsername' -IncludePamVaults -IncludeVault @();
        $search = $searchRes[0];
        $pamAccountRes = Get-DSPamAccount -AccountID $search.ID

Obtenir le compte PAM dont le nom d'utilisateur est 'MyUsername'. Dans cet exemple, on suppose que le nom d'utilisateur est unique, de sorte que le résultat de la recherche contient un seul résultat.

Exemple 2

PS C:\> $pamBasicRes = Get-DSPamAccount -AsBasicInformation;
        $nameStarts = $pamBasicRes | Where Label -like 'MyName*';
        foreach ($pamBasic in $nameStarts) { Remove-DSPamAccount -AccountID $pamBasic.ID }

Supprimer tous les comptes PAM dont le nom commence par 'MyName'.

Paramètres

-AccountID

ID du compte PAM.

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

-AddActiveCheckoutID

Ajouter la propriété CheckoutID contenant l'ID de l'extraction active.

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

-AsBasicInformation

L'objet retourné sera simplifié. Il permet une identification simple du compte PAM (ID, Label, Username, Domain), de son dossier PAM (FolderID, FolderName) et de son coffre PAM (TeamFolderID). Cette opération est plus rapide que l'obtention des objets complets des comptes PAM.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: BasicInformation
  Position: Named
  IsRequired: true
  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: ''

-IncludeDomainName

Inclure le nom de domaine. Cette information sera récupérée depuis le fournisseur PAM. Peut être utilisé par des non-administrateurs.

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

-VaultID

Obtenir tous les comptes dans le dossier spécifié.

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FolderID
ParameterSets:
- Name: GetByFolder
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
- Name: BasicInformation
  Position: Named
  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, voir about_CommonParameters.

Notes

Pour plus d'informations, saisissez "Get-Help Get-DSPamAccount -detailed". Pour des informations techniques, saisissez "Get-Help Get-DSPamAccount -full".