Get-DSPamAccount

Übersicht

PAM-Konten abrufen.

Syntax

GetByFolder (Standard)

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

Beschreibung

PAM-Konten abrufen. Es gibt drei Möglichkeiten, dies zu tun. Erstens: Rufen Sie ein bestimmtes Konto mit dem Parameter AccountID ab. Zweitens: Rufen Sie alle PAM-Konten ab, indem Sie das Cmdlet ohne Parameter aufrufen. Drittens: Rufen Sie alle PAM-Konten eines bestimmten Ordners mit dem Parameter FolderID ab. Falls es sehr viele PAM-Konten gibt, kann eine TryGoOfflineException auftreten. Ist dies der Fall, gibt es zwei Möglichkeiten, diesen Fehler zu vermeiden. Erstens: Verwenden Sie beim Aufruf von New-DSSession den Parameter Timeout, um die Abfrageverzögerung zu erhöhen. Eine andere Möglichkeit ist die Verwendung des Schalters AsBasicInformation dieses Cmdlets. Dies gibt ein vereinfachtes Objekt mit den Informationen zurück, um die relevanten PAM-Konten schnell zu identifizieren.

Beispiele

Beispiel 1

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

Ruft das PAM-Konto ab, dessen Benutzername 'MyUsername' ist. In diesem Beispiel wird davon ausgegangen, dass der Benutzername eindeutig ist, sodass das Suchergebnis ein einzelnes Ergebnis enthält.

Beispiel 2

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

Löscht alle PAM-Konten, deren Name mit 'MyName' beginnt.

Parameter

-AccountID

ID des PAM-Kontos

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

Fügt die Eigenschaft CheckoutID hinzu, die die ID des aktiven Auscheckvorgangs enthält

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

Das zurückgegebene Objekt wird vereinfacht. Es ermöglicht die einfache Identifizierung des PAM-Kontos (ID, Label, Username, Domain), seines PAM-Ordners (FolderID, FolderName) und seines PAM-Tresors (TeamFolderID). Dies ist schneller als das Abrufen der vollständigen PAM-Konten-Objekte.

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

In Versionen vor 2024.2 gaben viele DS-Cmdlets ein ServerResponse-Objekt zurück. Durch Aktivieren dieses Schalters für Rückwärtskompatibilität funktionieren Skripte, die für frühere Versionen entwickelt wurden, weiterhin korrekt.

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

Schließt den Domänennamen ein. Dieser wird vom PAM-Anbieter abgerufen. Kann von Nicht-Administratoren verwendet werden.

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

Ruft alle Konten im angegebenen Ordner ab

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

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Hinweise

Weitere Informationen erhalten Sie mit "Get-Help Get-DSPamAccount -detailed". Technische Informationen erhalten Sie mit "Get-Help Get-DSPamAccount -full".