Delen via

Start-SCOMTask

  • Referentie
Module:
OperationsManager

Hiermee start u een taak voor een opgegeven object.

Syntax

Start-SCOMTask
     [-Instance] <EnterpriseManagementObject[]>
     [-Task] <ManagementPackTask>
     -TaskCredentials <PSCredential>
     [[-Override] <Hashtable>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

De cmdlet Start-SCOMTask start een taak voor een opgegeven object. Deze cmdlet gebruikt een taakobject en een klasse-exemplaarobject als invoer. De cmdlet accepteert slechts één taak, maar kan meerdere klasse-exemplaren en onderdrukkingen accepteren.

Voorbeelden

Voorbeeld 1: Een taak starten met behulp van een weergavenaam

PS C:\>$Instances = Get-SCOMClassInstance -Name "*.Contoso.com"
PS C:\> Get-SCOMTask -DisplayName "Get Monitor State" | Start-SCOMTask -Instance $Instances

In dit voorbeeld wordt een taak gestart met behulp van een weergavenaam.

Met de eerste opdracht worden alle klasse-exemplaren in het Contoso.com domein opgeslagen en opgeslagen in de variabele $Instances.

Met de tweede opdracht wordt de taak met de weergavenaam Monitorstatus ophalen en wordt de taak gestart voor elk klasse-exemplaar dat is opgeslagen in de $Instances variabele.

Voorbeeld 2: Een taak starten met behulp van een weergavenaam en een time-outspecificatie

PS C:\>$Overrides = @{Timeout=60}
PS C:\> $Instances = Get-SCOMClassInstance -DisplayName "Contoso Service"
PS C:\> $Task = Get-SCOMTask -DisplayName "Start NT Service"
PS C:\> Start-SCOMTask -Task $Task -Instance $Instances -Override $Overrides

In dit voorbeeld ziet u hoe u een taak start met behulp van een weergavenaam en een hashtabel waarmee een time-outwaarde wordt opgegeven.

Met de eerste opdracht maakt u een hash-tabel met een waarde voor de time-outsleutel en slaat deze op in de $Overrides variabele.

Met de tweede opdracht worden alle klasse-exemplaren met de naam Contoso Service opgeslagen en opgeslagen in de variabele $Instances.

Met de derde opdracht wordt de taak met de weergavenaam NT-service gestart en wordt de taak gestart voor elk klasse-exemplaar dat is opgeslagen in de $Instances variabele.

Met de vierde opdracht wordt de taak gestart voor elk klasse-exemplaar dat is opgeslagen in de $Instances variabele. Met de opdracht wordt een time-outsleutelwaarde van 60 opgegeven.

Voorbeeld 3: Een taak starten met behulp van referenties

PS C:\>$Credential = Get-Credential
PS C:\> $Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> Get-SCOMTask -DisplayName "Reset State" | Start-SCOMTask -Instance $Instance -TaskCredentials $Credential

In dit voorbeeld wordt een taak gestart met behulp van referenties.

De eerste opdracht vraagt de gebruiker om een gebruikersnaam en wachtwoord, maakt een referentieobject op basis van de invoer en slaat het referentieobject op in de $Credential variabele.

Met de tweede opdracht wordt een klasse-exemplaar met de naam Server01.Contoso.com en opgeslagen in de $Instance variabele.

Met de derde opdracht krijgt u een taak met de weergavenaam Reset State en start u de taak voor het klasse-exemplaar dat is opgeslagen in $Instance. Met de opdracht wordt de taak uitgevoerd onder de referenties die zijn opgeslagen in $Credential.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Instance

Hiermee geeft u een matrix van EnterpriseManagementObject-objecten die klasse-exemplaarobjecten vertegenwoordigen waarvoor een taak moet worden gestart. Geef een variabele op waarin de klasse-exemplaren worden opgeslagen of gebruik een cmdlet zoals de Get-SCOMClassInstance-cmdlet waarmee de klasse-exemplaren worden opgeslagen. 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:False
Accept wildcard characters:False

-Override

Hiermee geeft u een hashtabel op die nieuwe waarden definieert voor een of meer taakparameters, als deze parameters onderdrukkingen toestaan. Typ 'Get-Help about_Hash_Tables' voor meer informatie over hashtabellen.

Als u wilt bepalen welke parameters voor een taak onderdrukkingen toestaan, gebruikt u de methode GetOverrideableParameters voor het taakobject.

Type:Hashtable
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Task

Hiermee geeft u een taakobject te starten. Geef een variabele op die een taak vertegenwoordigt of gebruik een cmdlet zoals de Get-SCOMTask-cmdlet die een taak ophaalt. Deze parameter accepteert slechts één taakobject.

Type:ManagementPackTask
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TaskCredentials

Hiermee geeft u het gebruikersaccount waaronder de verbinding met de beheergroep wordt uitgevoerd. Geef voor deze parameter een PSCredential-object op, zoals een object dat door de cmdlet Get-Credential wordt geretourneerd. 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.

Dit is een verplichte parameter. Als u een null-waarde opgeeft, gebruikt Operations Manager de standaard TaskCredentials van het account voor de huidige gebruiker.

Type:PSCredential
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False