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 task e un oggetto istanza di classe come input. Il cmdlet accetta una sola attività, ma può accettare più istanze di classe e sostituzioni.

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 della 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 della 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

Questo esempio avvia 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 Reset State e avvia l'attività per l'istanza della classe archiviata in $Instance. Il comando esegue l'attività con le credenziali archiviate in $Credential.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Instance

Specifica una matrice di oggetti EnterpriseManagementObject che rappresentano gli oggetti dell'istanza della classe per cui avviare un'attività. Specificare una variabile che archivia le istanze della classe o usare un cmdlet, ad esempio 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 .

Tipo:EnterpriseManagementObject[]
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 le sostituzioni, utilizzare il metodo GetOverrideableParameters per l'oggetto attività.

Tipo:Hashtable
Posizione:4
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Task

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

Tipo:ManagementPackTask
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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 tale parametro viene visualizzato.

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.

Tipo:PSCredential
Posizione:3
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False