Delen via

Get-SCOMTask

  • Referentie
Module:
OperationsManager

Hiermee haalt u een lijst met taken op.

Syntaxis

Get-SCOMTask
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   -Id <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-Instance] <EnterpriseManagementObject[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-ManagementPack] <ManagementPack[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-Name <String[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-Target <ManagementPackClass[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

De cmdlet Get-SCOMTask haalt een lijst met taken op. Gebruik deze cmdlet om taken op te halen die een specifieke naam of id hebben, evenals taken die zijn gekoppeld aan opgegeven gebruikersrollen, klasse-exemplaren, management packs of doelklassen.

Voorbeelden

Voorbeeld 1: Taken ophalen door een gedeeltelijke naam op te geven

PS C:\>Get-SCOMTask -Name "*health*"

Met deze opdracht worden alle taken met de status in hun namen opgeslagen.

Voorbeeld 2: Een taak ophalen met behulp van een gedeeltelijke weergavenaam

PS C:\>Get-SCOMTask -DisplayName "Stop*"

Met deze opdracht krijgt u alle taken met weergavenamen die beginnen met Stoppen.

Voorbeeld 3: Een taak ophalen door een gedeeltelijke weergavenaam en een foutactie op te geven

PS C:\>Get-SCOMManagementPack -DisplayName "System Center Core*" | Get-SCOMTask -ErrorAction SilentlyContinue

Met deze opdracht worden alle taken voor de management packs met System Center Core in hun weergavenamen weergegeven. De opdracht gebruikt de cmdlet Get-SCOMManagementPack om management packs op basis van weergavenamen op te halen en door te geven aan de Get-SCOMTask cmdlet. Omdat met de opdracht SilentlyContinue wordt opgegeven voor de parameter ErrorAction, blijft de cmdlet een management pack zonder gekoppelde taken vinden en worden er geen foutberichten weergegeven.

Voorbeeld 4: Taken ophalen met behulp van een gedeeltelijke klassenaam

PS C:\>Get-SCOMClass -Name "*health*" | Get-SCOMTask

Met deze opdracht worden alle taken voor klassen met de status in hun namen opgeslagen.

Voorbeeld 5: Taken ophalen door een naam voor een gedeeltelijke klasse-instantie op te geven

PS C:\>Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMTask

Met deze opdracht worden alle taken voor klasse-exemplaren met .Contoso.com in hun namen opgeslagen.

Voorbeeld 6: Een taak ophalen door een id op te geven

PS C:\>Get-SCOMTask -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd

Met deze opdracht wordt de taak opgehaald met een id van 7413b06b-a95b-4ae3-98f2-dac9ff76dabd.

Parameters

-ComputerName

Hiermee geeft u een matrix van namen van computers. Met de cmdlet worden tijdelijke verbindingen met beheergroepen voor deze computers tot stand gebracht. U kunt NetBIOS-namen, IP-adressen of FQDN's (Fully Qualified Domain Names) gebruiken. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

De computer moet de System Center Data Access-service uitvoeren.

Als u deze parameter niet opgeeft, is de standaardwaarde de computer voor de huidige verbinding met de beheergroep.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u het gebruikersaccount waaronder de verbinding met de beheergroep wordt uitgevoerd. Geef een PSCredential--object op, zoals een object dat door de Get-Credential cmdlet wordt geretourneerd voor deze parameter. Voor meer informatie over referentieobjecten typt uGet-Help Get-Credential".

Dit account moet toegang hebben tot de server die is opgegeven in de parameter ComputerName als deze parameter wordt weergegeven.

Als u deze parameter niet opgeeft, is de standaardwaarde het account voor de huidige gebruiker.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

Hiermee geeft u een matrix van weergavenamen voor taakobjecten. Deze parameter gebruikt een of meer tekenreeksen en de cmdlet zoekt naar overeenkomsten tussen de weergavenamen van de taakobjecten waarmee de cmdlet werkt. De waarden voor deze parameter variëren, afhankelijk van welke gelokaliseerde management packs worden geïmporteerd in de beheergroep en de landinstelling van de gebruiker waarop Windows PowerShell wordt uitgevoerd.

Type:String[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Id

Hiermee geeft u een matrix van taak-id's. De cmdlet haalt de taken op met deze id's. Gebruik de cmdlet Get-SCOMTask om een taak te verkrijgen. De id is de id eigenschap van een taakobject.

Type:Guid[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Instance

Hiermee geeft u een matrix van EnterpriseManagementObject objecten die klasse-exemplaren vertegenwoordigen. De cmdlet haalt taken op voor de klasse-exemplaren die door de matrix worden opgeslagen. Geef een variabele op die de klasse-exemplaren vertegenwoordigt of gebruik een cmdlet zoals Get-SCOMClassInstance die de klasse-exemplaren ophaalt. Deze parameter accepteert ook groepsobjecten. Gebruik de cmdlet Get-SCOMGroup om een groepsobject op te halen.

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ManagementPack

Hiermee geeft u een matrix van management pack-objecten. De cmdlet haalt taken op voor de management pack-objecten in de matrix. Geef een variabele op die management pack-objecten bevat of gebruik een cmdlet zoals Get-SCOMManagementPack waarmee management pack-objecten worden opgehaald.

Type:ManagementPack[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u een matrix van taaknamen.

De cmdlet neemt elke tekenreeks in de matrix en komt overeen met de naam eigenschappen van de taakobjecten waarmee deze cmdlet werkt.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-SCSession

Hiermee geeft u een matrix van Connection-objecten. Als u Connection-objecten wilt ophalen, geeft u de cmdlet Get-SCOMManagementGroupConnection op.

Als deze parameter niet wordt weergegeven, gebruikt de cmdlet de actieve permanente verbinding met een beheergroep. Gebruik de parameter SCSession om een andere permanente verbinding op te geven. U kunt een tijdelijke verbinding met een beheergroep maken met behulp van de parameters ComputerName en Credential. Typ 'Get-Help about_OpsMgr_Connections' voor meer informatie.

Type:Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Target

Hiermee geeft u een matrix van management pack-klasseobjecten die doelklassen vertegenwoordigen. Geef een variabele op die de doelklasseobjecten bevat of gebruik een cmdlet zoals Get-SCOMClass- waarmee de doelklasseobjecten worden opgehaald.

Type:ManagementPackClass[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False