Condividi tramite

Start-SCOMTask

  • Riferimento
Modulo:
OperationsManager

Avvia un'attività per un oggetto specificato.

Sintassi

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

Descrizione

Il cmdlet Start-SCOMTask avvia un'attività per un oggetto specificato. Questo cmdlet accetta un oggetto attività e un oggetto istanza di classe come input. Il cmdlet accetta solo un'attività, ma può accettare più istanze di classe e override.

Esempio

Esempio 1: Avviare un'attività usando un nome visualizzato

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

In questo esempio viene avviata un'attività usando un nome visualizzato.

Il primo comando ottiene tutte le istanze della classe nel dominio Contoso.com e le archivia nella variabile $Instances.

Il secondo comando ottiene l'attività con il nome visualizzato Get Monitor State e avvia l'attività per ogni istanza di classe archiviata nella variabile $Instances.

Esempio 2: Avviare un'attività usando un nome visualizzato e una specifica di timeout

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 questo esempio viene illustrato come avviare un'attività usando un nome visualizzato e una tabella hash che specifica un valore di timeout.

Il primo comando crea una tabella hash con un valore per la chiave Timeout e la archivia nella variabile $Overrides.

Il secondo comando ottiene tutte le istanze della classe con il nome Contoso Service e le archivia nella variabile $Instances.

Il terzo comando ottiene l'attività con il nome visualizzato Start NT Service e avvia l'attività per ogni istanza di classe archiviata nella variabile $Instances.

Il quarto comando avvia l'attività per ogni istanza di classe archiviata nella variabile $Instances. Il comando specifica un valore di chiave timeout pari a 60.

Esempio 3: Avviare un'attività usando le credenziali

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 questo esempio viene avviata un'attività usando le credenziali.

Il primo comando richiede all'utente un nome utente e una password, crea un oggetto credenziale dall'input e archivia l'oggetto credenziale nella variabile $Credential.

Il secondo comando ottiene un'istanza di classe denominata Server01.Contoso.com e la archivia nella variabile $Instance.

Il terzo comando ottiene un'attività con il nome visualizzato Reimposta stato e avvia l'attività per l'istanza della classe archiviata in $Instance. Il comando esegue l'attività sotto le credenziali archiviate in $Credential.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Instance

Specifica una matrice di oggetti EnterpriseManagementObject che rappresentano oggetti di istanza della classe per cui avviare un'attività. Specificare una variabile che archivia le istanze della classe o usare un cmdlet, ad esempio il cmdlet Get-SCOMClassInstance che ottiene le istanze della classe. Questo parametro accetta anche oggetti gruppo. Per ottenere un oggetto gruppo, usare il cmdlet Get-SCOMGroup .

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

-Override

Specifica una tabella hash che definisce nuovi valori per uno o più parametri dell'attività, se tali parametri consentono l'override. Per altre informazioni sulle tabelle hash, digitare "Get-Help about_Hash_Tables".

Per determinare quali parametri per un'attività consentono gli overridi, usare il metodo GetOverrideableParameters per l'oggetto attività.

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

-Task

Specifica un oggetto attività da avviare. Specificare una variabile che rappresenta un'attività o usare un cmdlet, ad esempio il cmdlet Get-SCOMTask che ottiene un'attività. Questo parametro accetta un solo oggetto attività.

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

-TaskCredentials

Specifica l'account utente in cui viene eseguita la connessione al gruppo di gestione. Specificare un oggetto PSCredential , ad esempio quello restituito dal cmdlet Get-Credential , per questo parametro. Per altre informazioni sugli oggetti credenziali, digitare "Get-Help Get-Credential".

Questo account deve avere accesso al server specificato nel parametro ComputerName se viene visualizzato tale parametro.

Si tratta di un parametro obbligatorio. Se si specifica un valore Null, Operations Manager usa le credenziali attività predefinite dell'account per l'utente corrente.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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