Invoke-DSPamCheckout

Übersicht

Erstellt eine Auscheck-Anfrage.

Syntax

__AllParameterSets

Invoke-DSPamCheckout -AccountID <guid> [-Reason <string>] [-ApproverID <guid>] [-Duration <int>]
 [-AsLegacyResponse] [<CommonParameters>]

Beschreibung

Erstellt eine Auscheck-Anfrage für die angegebene PAM-Anmeldeinformation. Gibt außerdem das Passwort zurück, wenn keine Genehmigung erforderlich ist oder wenn die genehmigende ID mit der ID des anfragenden Benutzers übereinstimmt.

Beispiele

Beispiel 1

PS C:\> $Response = Invoke-DSPamCheckout -PamCredentialID '92e1d27f-6e7b-4c62-86da-a04fc22603c2' -Verbose
        $BobPassword = $Response.Password
        $BobCheckoutInfo = $Response.CheckoutInfo
        $BobCheckinResponse = Invoke-DSPamCheckin $BobCheckoutInfo

Automatisches Auschecken der PAM-Anmeldeinformation (keine Genehmigung erforderlich)

Beispiel 2

PS C:\> $Response = Invoke-DSPamCheckout -PamCredentialID '2735a06c-baa0-4ff9-911c-aa1fcc03ea1e' -Reason 'Because' -ApproverID '49a60972-b1ff-4be9-ac73-47c6d4a4125d'
        $MauricePassword = $Response.Password
        $MauriceCheckoutInfo = $Response.CheckoutInfo
        $MauriceCheckinResponse = Invoke-DSPamCheckin $MauriceCheckoutInfo

Selbst-Auschecken der PAM-Anmeldeinformation (der Genehmiger ist dieselbe Person, die das Auschecken anfordert)

Beispiel 3

PS C:\> $Response = Invoke-DSPamCheckout -PamCredentialID '08a521fe-14f7-4ae5-b2b9-d9f6164c15e8' -ApproverID '2364ec1f-a739-450b-afe8-d85b5a3db50e' -Reason 'Because'
        # After approval
        $CheckoutResponse = Get-DSPamCheckout -CheckoutID $Response.ID
        $KellyPassword = Get-DSPamPassword -PamCredentialID $CheckoutResponse.CredentialID
        $KellyCheckoutInfo = $CheckoutResponse.CheckoutInfo
        $KellyCheckinResponse = Invoke-DSPamCheckin $KellyCheckoutInfo

Genehmigtes Auschecken der PAM-Anmeldeinformation (Genehmigung durch den angegebenen Genehmiger)

Parameter

-AccountID

ID der auszucheckenden PAM-Anmeldeinformation

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

-ApproverID

ID des Genehmigers. Erforderlich, wenn eine Genehmigung zwingend ist.

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  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 können für frühere Versionen entwickelte Skripte korrekt funktionieren.

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

-Duration

Dauer der Auscheck-Anfrage in Minuten. Standardmäßig ist sie auf 2 Stunden (120 Minuten) eingestellt.

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

-Reason

Informationen zur Auscheck-Anfrage, die zur Genehmigung an einen Administrator gesendet werden.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  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

Für weitere Informationen geben Sie "Get-Help Invoke-DSPamCheckout -detailed" ein. Für technische Informationen geben Sie "Get-Help Invoke-DSPamCheckout -full" ein.