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.