Start-SCOMTask
Hiermee start u een taak voor een opgegeven object.
Syntaxis
Default (Standaard)
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 neemt een taakobject en een klasse-instantieobject als invoer. De cmdlet accepteert slechts één taak, maar kan meerdere klasse-exemplaren en overschrijvingen 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.
De eerste opdracht haalt alle klasse-exemplaren op in het domein Contoso.com en slaat ze op in de variabele $Instances.
De tweede opdracht haalt de taak op met de weergavenaam Get Monitor State en start de taak voor elk klasse-exemplaar dat is opgeslagen in de $Instances variabele.
Voorbeeld 2: Start een taak 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 die een time-outwaarde opgeeft.
Met de eerste opdracht wordt een hashtabel gemaakt met een waarde voor de time-outsleutel en wordt deze opgeslagen in de variabele $Overrides.
Met de tweede opdracht worden alle klasse-exemplaren met de naam Contoso Service opgehaald en worden deze opgeslagen in de variabele $Instances.
De derde opdracht haalt de taak op met de weergavenaam Start NT Service en start de taak voor elk klasse-exemplaar dat is opgeslagen in de variabele $Instances.
Met de vierde opdracht wordt de taak gestart voor elk klasse-exemplaar dat is opgeslagen in de variabele $Instances. De opdracht geeft een Timeout-sleutelwaarde van 60 op.
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.
Met de eerste opdracht wordt de gebruiker gevraagd om een gebruikersnaam en wachtwoord, wordt een referentieobject gemaakt op basis van de invoer en wordt het referentieobject opgeslagen in de variabele $Credential.
De tweede opdracht haalt een klasse-instantie op met de naam Server01.Contoso.com en slaat deze op in de variabele $Instance.
Met de derde opdracht wordt een taak opgehaald met de weergavenaam Status opnieuw instellen en wordt de taak gestart 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
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Instance
Hiermee geeft u een matrix op van EnterpriseManagementObject-objecten die klasse-instantieobjecten vertegenwoordigen waarvoor een taak moet worden gestart. Geef een variabele op waarmee de klasse-exemplaren worden opgeslagen of gebruik een cmdlet zoals de cmdlet Get-SCOMClassInstance waarmee de klasse-exemplaren worden opgehaald. Deze parameter accepteert ook groepsobjecten. Als u een groepsobject wilt verkrijgen, gebruikt u de cmdlet Get-SCOMGroup .
Parametereigenschappen
| Type: | EnterpriseManagementObject[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 1 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Override
Hiermee geeft u een hashtabel op waarmee nieuwe waarden worden gedefinieerd voor een of meer taakparameters, als deze parameters overschrijvingen toestaan.
Typ "Get-Help about_Hash_Tables" voor meer informatie over hashtabellen.
Als u wilt bepalen welke parameters voor een taak overschrijvingen zijn toegestaan, gebruikt u de methode GetOverrideableParameters voor het taakobject.
Parametereigenschappen
| Type: | Hashtable |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 4 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Task
Hiermee geeft u een taakobject op dat moet worden gestart. Geef een variabele op die een taak vertegenwoordigt of gebruik een cmdlet zoals de cmdlet Get-SCOMTask waarmee een taak wordt opgehaald. Deze parameter accepteert slechts één taakobject.
Parametereigenschappen
| Type: | ManagementPackTask |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 2 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-TaskCredentials
Hiermee geeft u het gebruikersaccount op waaronder de verbinding met de beheergroep wordt uitgevoerd.
Geef een PSCredential-object op, zoals een object dat door de cmdlet Get-Credential wordt geretourneerd, voor deze parameter.
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 voorkomt.
Dit is een verplichte parameter. Als u een null-waarde opgeeft, gebruikt Operations Manager de standaard TaskCredentials van het account voor de huidige gebruiker.
Parametereigenschappen
| Type: | PSCredential |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 3 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.