Delen via

Get-SCOMTask

  • Referentie
Module:
OperationsManager

Hiermee haalt u een lijst met taken op.

Syntax

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 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 worden alle taken met weergavenamen weergegeven 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 opgeslagen. De opdracht maakt gebruik van de Cmdlet Get-SCOMManagementPack om management packs op basis van weergavenamen op te halen en door te geven aan de Get-SCOMTask-cmdlet . Omdat de opdracht SilentlyContinue opgeeft voor de parameter ErrorAction , als de cmdlet een management pack zonder gekoppelde taken vindt, blijft deze worden uitgevoerd 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 status in hun namen opgeslagen.

Voorbeeld 5: Taken ophalen door een gedeeltelijke naam van het klasse-exemplaar 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 standaardcomputer voor de huidige verbinding met de beheergroep.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

Dit account moet toegang hebben tot de server die is opgegeven in de parameter ComputerName als die 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Hiermee geeft u een matrix met 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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Instance

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

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Hiermee geeft u een matrix met taaknamen op.

De cmdlet gebruikt elke tekenreeks in de matrix en komt overeen met de naameigenschappen van de taakobjecten waarmee deze cmdlet werkt.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-SCSession

Hiermee geeft u een matrix van verbindingsobjecten op. Als u verbindingsobjecten wilt ophalen, geeft u de get-SCOMManagementGroupConnection-cmdlet op.

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

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters:False