Dela via

Start-SCOMTask

  • Referens
Modul:
OperationsManager

Startar en uppgift för ett angivet objekt.

Syntax

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

Description

Cmdleten Start-SCOMTask startar en aktivitet för ett angivet objekt. Den här cmdleten tar ett aktivitetsobjekt och ett klassinstansobjekt som indata. Cmdleten accepterar bara en uppgift, men den kan acceptera flera klassinstanser och åsidosättningar.

Exempel

Exempel 1: Starta en aktivitet med ett visningsnamn

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

Det här exemplet startar en aktivitet med hjälp av ett visningsnamn.

Det första kommandot hämtar alla klassinstanser i Contoso.com-domänen och lagrar dem i variabeln $Instances.

Det andra kommandot hämtar uppgiften som har visningsnamnet Hämta övervakningstillstånd och startar uppgiften för varje klassinstans som lagras i variabeln $Instances.

Exempel 2: Starta en aktivitet med ett visningsnamn och en tidsgränsspecifikation

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

Det här exemplet visar hur du startar en aktivitet med hjälp av ett visningsnamn och en hash-tabell som anger ett timeout-värde.

Det första kommandot skapar en hash-tabell som har ett värde för timeout-nyckeln och lagrar den i variabeln $Overrides.

Det andra kommandot hämtar alla klassinstanser som har namnet Contoso Service och lagrar dem i variabeln $Instances.

Det tredje kommandot hämtar uppgiften som har visningsnamnet Start NT Service och startar uppgiften för varje klassinstans som lagras i variabeln $Instances.

Det fjärde kommandot startar uppgiften för varje klassinstans som lagras i variabeln $Instances. Kommandot anger ett timeout-nyckelvärde på 60.

Exempel 3: Starta en aktivitet med hjälp av autentiseringsuppgifter

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

Det här exemplet startar en uppgift med hjälp av autentiseringsuppgifter.

Det första kommandot uppmanar användaren att ange ett användarnamn och lösenord, skapar ett autentiseringsobjekt från indata och lagrar objektet för autentiseringsuppgifter i variabeln $Credential.

Det andra kommandot hämtar en klassinstans med namnet Server01.Contoso.com och lagrar den i variabeln $Instance.

Det tredje kommandot hämtar en aktivitet med visningsnamnet Återställ tillstånd och startar uppgiften för den klassinstans som lagras i $Instance. Kommandot kör uppgiften under de autentiseringsuppgifter som lagras i $Credential.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Instance

Anger en matris med EnterpriseManagementObject-objekt som representerar klassinstansobjekt som en aktivitet ska startas för. Ange en variabel som lagrar klassinstanserna eller använder en cmdlet, till exempel cmdleten Get-SCOMClassInstance som hämtar klassinstanserna. Den här parametern accepterar även gruppobjekt. Om du vill hämta ett gruppobjekt använder du cmdleten Get-SCOMGroup .

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

-Override

Anger en hash-tabell som definierar nya värden för en eller flera aktivitetsparametrar, om dessa parametrar tillåter åsidosättningar. Om du vill ha mer information om hash-tabeller skriver du "Get-Help about_Hash_Tables".

Om du vill avgöra vilka parametrar för en aktivitet som tillåter åsidosättningar använder du metoden GetOverrideableParameters för aktivitetsobjektet .

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

-Task

Anger ett aktivitetsobjekt som ska startas. Ange en variabel som representerar en uppgift eller använd en cmdlet, till exempel cmdleten Get-SCOMTask som hämtar en uppgift. Den här parametern accepterar bara ett aktivitetsobjekt.

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

-TaskCredentials

Anger det användarkonto som hanteringsgruppens anslutning körs under. Ange ett PSCredential-objekt , till exempel ett som cmdleten Get-Credential returnerar för den här parametern. Om du vill ha mer information om autentiseringsobjekt skriver du "Get-Help Get-Credential".

Det här kontot måste ha åtkomst till servern som anges i parametern ComputerName om parametern visas.

Det här är en obligatorisk parameter. Om du anger ett null-värde använder Operations Manager standardvärdet TaskCredentials för kontot för den aktuella användaren.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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