Invoke-CMScript
SYNOPSIS
Vyvolá skript v 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
Rutina Invoke-CMScript vyvolá skript prostředí PowerShell v Configuration Manager. Configuration Manager má integrovanou schopnost spouštět skripty prostředí PowerShell. Tyto skripty zjednodušují vytváření vlastních nástrojů pro správu softwaru a umožňují rychle provádět rutinní úkoly, což vám umožní rychleji a častěji pracovat s velkými úlohami. Další informace najdete v tématu Vytvoření a spuštění skriptů PowerShellu z konzoly Configuration Manager.
Poznámka
Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: vyvolání skriptu pomocí ID skriptu
Tento příkaz vyvolá skript s ID DF8E7546-FD66-4A3D-A129-53AF5AA54F80.
Invoke-CMScript -ScriptGuid "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"
Příklad 2: vyvolání skriptu pomocí proměnné objektu Script
První příkaz načte objekt CMScript podle jeho ID a pak ho uloží do proměnné $ScriptObj . Druhý příkaz vyvolá skript uložený v této proměnné.
$ScriptObj = Get-CMScript -Id "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"
Invoke-CMScript -InputObject $ScriptObj
Příklad 3: předání parametrů cílovému skriptu
První řádek ukládá parametry v zatřiďovací tabulce. Druhý řádek vyvolá skript na cílovém zařízení s předáním parametrů v zatřiďovací tabulce.
$Hash = @{"FolderName"="c:\test\test1"; "FileName"="test2"}
Invoke-CMScript -ScriptGuid $scriptGuid -Device (Get-CMDevice -Name $targetPCName) -ScriptParameter $Hash
PARAMETERS
– Kolekce
Zadejte objekt kolekce. K získání tohoto objektu použijte rutinu Get-CMCollection .
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Zadejte ID kolekce.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Zadejte název kolekce.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Zařízení
Zadejte objekt zařízení v Configuration Manager. K získání tohoto objektu použijte rutinu Get-CMDevice .
Type: IResultObject[]
Parameter Sets: (All)
Aliases: Devices
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Položky InputObject
Zadejte Configuration Manager objekt skriptu. K získání tohoto objektu použijte rutinu Get-CMScript .
Type: IResultObject
Parameter Sets: ByInputObject
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
– PassThru
Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScriptGuid
Zadejte ID skriptu. Formát je standardní identifikátor GUID.
Type: String
Parameter Sets: ByGuid
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScriptParameter
Platí pro verzi 2010 a novější. Tento parametr použijte k předání parametrů cílovému skriptu. Zadejte zatřiďovací tabulku s požadovanými parametry. Příklad použití naleznete v tématu Příklady.
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěná.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.