Dela via

Start-SCOMTask

  • Referens
Modul:
OperationsManager

Startar en aktivitet 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 uppgift för ett angivet objekt. Den här cmdleten tar ett aktivitetsobjekt och ett klassinstansobjekt som indata. Cmdleten accepterar endast en uppgift, men den kan acceptera flera klassinstanser och åsidosättningar.

Exempel

Exempel 1: Starta en aktivitet med hjälp av 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 domänen Contoso.com och lagrar dem i variabeln $Instances.

Det andra kommandot hämtar den uppgift 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 den uppgift 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 uppgift med 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 autentiseringsobjektet 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.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 Get-SCOMClassInstance cmdlet som hämtar klassinstanserna. Den här parametern accepterar även gruppobjekt. Om du vill hämta ett gruppobjekt använder du cmdleten Get-SCOMGroup.

Typ:EnterpriseManagementObject[]
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Hashtable
Position:4
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Task

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

Typ:ManagementPackTask
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TaskCredentials

Anger det användarkonto under vilket anslutningen till hanteringsgruppen körs. Ange ett PSCredential- objekt, till exempel ett objekt 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 den server 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.

Typ:PSCredential
Position:3
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False