Get-DSPamAccount

Sinopsis

Obtener cuentas pam.

Sintaxis

GetByFolder (predeterminado)

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

Descripción

Obtener cuentas pam. Hay tres formas de hacerlo. Primero, obtener una cuenta específica usando el parámetro AccountID. Segundo, obtener todas las cuentas pam llamando al cmdlet sin parámetros. Tercero, obtener todas las cuentas pam de una carpeta específica usando el parámetro FolderID. En caso de que haya muchas cuentas PAM, es posible que se produzca una TryGoOfflineException. Si es así, hay dos formas de evitar ese error. Primero, al llamar a New-DSSession, use el parámetro Timeout para aumentar el retardo de sondeo. Otra forma es usar el modificador AsBasicInformation de este cmdlet. Esto devolverá un objeto simplificado con la información necesaria para identificar rápidamente las cuentas PAM de interés.

Ejemplos

Ejemplo 1

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

Obtener la cuenta PAM cuyo nombre de usuario es 'MyUsername'. En este ejemplo se asume que el nombre de usuario es único, por lo que el resultado de la búsqueda contiene un único resultado.

Ejemplo 2

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

Eliminar todas las cuentas PAM cuyo nombre empieza por 'MyName'.

Parámetros

-AccountID

ID de la cuenta 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

Añade la propiedad CheckoutID que contiene el ID del checkout activo

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

El objeto devuelto será simplificado. Permite identificar de forma sencilla la cuenta PAM (ID, Label, Username, Domain), su carpeta PAM (FolderID, FolderName) y su bóveda PAM (TeamFolderID). Es más rápido que obtener los objetos completos de las cuentas 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

En versiones anteriores a 2024.2, muchos cmdlets de DS devolvían un objeto ServerResponse. Al habilitar este modificador de compatibilidad retroactiva, los scripts desarrollados para versiones anteriores pueden funcionar 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: ''

-IncludeDomainName

Incluye el nombre de dominio. Se obtendrá del proveedor PAM. Puede ser utilizado por usuarios no administradores.

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

Obtener todas las cuentas de la carpeta especificada

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

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

Notas

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