Delen via


Invoke-CMScript

SYNOPSIS

Roep een script aan in Configuration Manager.

SYNTAX

ByInputObject

Invoke-CMScript [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
 [-Device <IResultObject[]>] -InputObject <IResultObject> [-PassThru] [-ScriptParameter <Hashtable>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

ByGuid

Invoke-CMScript [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
 [-Device <IResultObject[]>] [-PassThru] -ScriptGuid <String> [-ScriptParameter <Hashtable>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

De Invoke-CMScript-cmdlet roept een PowerShell-script aan in Configuration Manager. Configuration Manager beschikt over een geïntegreerde mogelijkheid om PowerShell-scripts uit te voeren. De scripts vereenvoudigen het bouwen van aangepaste hulpprogramma's voor het beheren van software en bieden u de mogelijkheid om alledaagse taken snel uit te voeren, zodat u eenvoudiger en consistenter grote taken kunt uitvoeren. Zie PowerShell-scripts maken en uitvoerenvanuit de Configuration Manager console voor meer informatie.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een script aanroepen met behulp van de script-id

Met deze opdracht wordt een script aanroepen met de id DF8E7546-FD66-4A3D-A129-53AF5AA54F80.

Invoke-CMScript -ScriptGuid "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"

Voorbeeld 2: Een script aanroepen met behulp van een scriptobjectvariabele

De eerste opdracht haalt een CMScript-object op op de id en slaat het vervolgens op in de $ScriptObj variabele. Met de tweede opdracht wordt het script aanroepen dat is opgeslagen in die variabele.

$ScriptObj = Get-CMScript -Id "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"

Invoke-CMScript -InputObject $ScriptObj

Voorbeeld 3: Parameters doorgeven aan het doelscript

De eerste regel slaat parameters op in een hashtabel. De tweede regel roept het script aan op het doelapparaat en geeft de parameters door in de hashtabel.

$Hash = @{"FolderName"="c:\test\test1"; "FileName"="test2"}

Invoke-CMScript -ScriptGuid $scriptGuid -Device (Get-CMDevice -Name $targetPCName) -ScriptParameter $Hash

PARAMETERS

-Collection

Geef een verzamelingsobject op. Gebruik de cmdlet Get-CMCollection om dit object op te halen.

Type: IResultObject
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionId

Geef de id van een verzameling op.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionName

Geef de naam van een verzameling op.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Apparaat

Geef een apparaatobject op in Configuration Manager. Gebruik de cmdlet Get-CMDevice om dit object op te halen.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: Devices

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Geef een Configuration Manager scriptobject op. Gebruik de cmdlet Get-CMScript om dit object op te halen.

Type: IResultObject
Parameter Sets: ByInputObject
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-PassThru

Retourneert een -object dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ScriptGuid

Geef de script-id op. De THe-indeling is een standaard-GUID.

Type: String
Parameter Sets: ByGuid
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ScriptParameter

Is van toepassing op versie 2010 en hoger. Gebruik deze parameter om parameters door te geven aan het doelscript. Geef een hashtabel op met de vereiste parameters. Zie Voorbeelden voor een voorbeeld van gebruik.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

CmScript goedkeuren

Deny-CMScript

Get-CMScript

Remove-CMScript

Set-CMScriptDeploymentType

Add-CMScriptDeploymentType