Get-PSUJob

ÜBERSICHT

Gibt Jobs zurück, die in PSU ausgeführt wurden.

SYNTAX

All (Standard)

Get-PSUJob [-Status <JobStatus>] [-OrderBy <String>] [-OrderDirection <OrderDirection>]
 [-HideChildren <Boolean>] [-HideScheduled <Boolean>] [-HideTriggered <Boolean>] [-HideArchived <Boolean>]
 [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [-IncludeTotalCount]
 [-Skip <UInt64>] [-First <UInt64>] [<CommonParameters>]

Id

Get-PSUJob [-Id] <Int64> [-Status <JobStatus>] [-OrderBy <String>] [-OrderDirection <OrderDirection>]
 [-HideChildren <Boolean>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [-IncludeTotalCount] [-Skip <UInt64>] [-First <UInt64>] [<CommonParameters>]

RunId

Get-PSUJob -RunId <Guid> [-Status <JobStatus>] [-OrderBy <String>] [-OrderDirection <OrderDirection>]
 [-HideChildren <Boolean>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [-IncludeTotalCount] [-Skip <UInt64>] [-First <UInt64>] [<CommonParameters>]

Identity

Get-PSUJob [-Identity] <Identity> [-Status <JobStatus>] [-OrderBy <String>] [-OrderDirection <OrderDirection>]
 [-HideChildren <Boolean>] [-HideScheduled <Boolean>] [-HideTriggered <Boolean>] [-HideArchived <Boolean>]
 [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [-IncludeTotalCount]
 [-Skip <UInt64>] [-First <UInt64>] [<CommonParameters>]

Script

Get-PSUJob [-Script] <Script> [-Status <JobStatus>] [-OrderBy <String>] [-OrderDirection <OrderDirection>]
 [-HideChildren <Boolean>] [-HideScheduled <Boolean>] [-HideTriggered <Boolean>] [-HideArchived <Boolean>]
 [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [-IncludeTotalCount]
 [-Skip <UInt64>] [-First <UInt64>] [<CommonParameters>]

Schedule

Get-PSUJob -Schedule <Schedule> [-Status <JobStatus>] [-OrderBy <String>] [-OrderDirection <OrderDirection>]
 [-HideChildren <Boolean>] [-HideScheduled <Boolean>] [-HideTriggered <Boolean>] [-HideArchived <Boolean>]
 [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [-IncludeTotalCount]
 [-Skip <UInt64>] [-First <UInt64>] [<CommonParameters>]

BESCHREIBUNG

Gibt Jobs zurück, die in PSU ausgeführt wurden.

BEISPIELE

Beispiel 1

PS C:\> Get-UAJob

Gibt alle in PSU ausgeführten Jobs zurück.

Beispiel 2

PS C:\> Get-UAJob -Id 10

Gibt Job 10 von PSU zurück.

Beispiel 3

PS C:\> $Script = Get-UAScript -Id 4
PS C:\> Get-UAJob -Script $Script

Gibt alle Jobs zurück, die für das Skript mit der ID 4 ausgeführt wurden.

Beispiel 4

PS C:\> Get-UAJob -Id 10 -Tree

Gibt Job 10 und alle damit verbundenen Jobs (übergeordnete/untergeordnete Jobs) zurück.

PARAMETER

-AppToken

Ein App-Token für den Zugriff auf die PSU-API.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ComputerName

Die HTTP-Adresse des PSU-REST-API-Servers.

Type: String
Parameter Sets: (All)
Aliases: Uri

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-First

Ruft nur die angegebene Anzahl von Objekten ab. Geben Sie die Anzahl der abzurufenden Objekte ein.

Type: UInt64
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Id

Die ID des zurückzugebenden Jobs.

Type: Int64
Parameter Sets: Id
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Identity

Gibt Jobs zurück, die von dieser Identität ausgeführt wurden.

Type: Identity
Parameter Sets: Identity
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-IncludeTotalCount

Meldet die Gesamtanzahl der Objekte im Datensatz (eine ganze Zahl), gefolgt von den ausgewählten Objekten. Wenn das Cmdlet die Gesamtanzahl nicht ermitteln kann, wird "Unknown total count." angezeigt. Die ganze Zahl verfügt über eine Accuracy-Eigenschaft, die die Zuverlässigkeit des Werts der Gesamtanzahl angibt. Der Wert von Accuracy liegt zwischen 0.0 und 1.0, wobei 0.0 bedeutet, dass das Cmdlet die Objekte nicht zählen konnte, 1.0 bedeutet, dass die Anzahl exakt ist, und ein Wert zwischen 0.0 und 1.0 auf eine zunehmend zuverlässige Schätzung hinweist.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Integrated

Führt den Befehl intern aus, anstatt die Management-API zu verwenden. Funktioniert nur, wenn das Skript innerhalb von PowerShell Universal ausgeführt wird.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OrderBy

Ordnet die Ausgabe basierend auf der ausgewählten Eigenschaft.

Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Id, StartTime, EndTime

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OrderDirection

Ordnet aufsteigend oder absteigend.

Type: OrderDirection
Parameter Sets: (All)
Aliases:
Accepted values: Descending, Ascending

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Script

Gibt Jobs basierend auf diesem Skript zurück.

Type: Script
Parameter Sets: Script
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Skip

Ignoriert die angegebene Anzahl von Objekten und ruft dann die verbleibenden Objekte ab. Geben Sie die Anzahl der zu überspringenden Objekte ein.

Type: UInt64
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Status

Filtert die Ausgabe basierend auf diesem Status.

Type: JobStatus
Parameter Sets: (All)
Aliases:
Accepted values: Queued, Running, Completed, Failed, WaitingOnFeedback, Canceled, Canceling, Historical, Active, TimedOut, Warning

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseDefaultCredentials

Standard-Anmeldeinformationen bei der Verbindung mit der Management-API verwenden

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunId

Die Run-ID (GUID) für diesen Job. Erfordert die experimentelle Funktion JobRunId.

Type: Guid
Parameter Sets: RunId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Schedule

Gibt den anzusprechenden Zeitplan an.

Type: Schedule
Parameter Sets: Schedule
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Credential

Anmeldeinformationen für die Anmeldung an der PowerShell Universal Management-API.

Type: PSCredential
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-HideChildren

Gibt keine untergeordneten Jobs zurück.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-HideScheduled

Gibt keine geplanten Jobs zurück.

Type: Boolean
Parameter Sets: All, Identity, Script, Schedule
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-HideTriggered

Gibt keine ausgelösten Jobs zurück.

Type: Boolean
Parameter Sets: All, Identity, Script, Schedule
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TrustCertificate

Gibt an, ob das Cmdlet Zertifikatsprobleme ignorieren soll.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Cookies

Verwendet Authentifizierungscookies für die aktuelle PowerShell-Sitzung erneut und speichert sie dauerhaft.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-HideArchived

Schließt archivierte Jobs von den Ergebnissen aus, wenn auf $true gesetzt.

Type: Boolean
Parameter Sets: All, Identity, Script, Schedule
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

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