Invoke-CMScript

  • Referencia
Módulo:
ConfigurationManager

Ejecute un script de PowerShell en Configuration Manager.

Syntax

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

Description

Use este cmdlet para ejecutar un script de PowerShell en Configuration Manager. Estos scripts se integran y administran en Configuration Manager.

No puede ejecutar un script hasta que se apruebe. Para aprobar scripts mediante programación, use el cmdlet Approve-CMScript .

Para obtener más información, consulte Creación y ejecución de scripts de PowerShell desde la consola de Configuration Manager.

Nota:

Ejecute Configuration Manager cmdlets desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Ejecución de un script mediante su identificador

Este comando ejecuta el script con el identificador DF8E7546-FD66-4A3D-A129-53AF5AA54F80.

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

Ejemplo 2: Ejecución de un script mediante una variable de objeto

El primer comando obtiene un objeto de script por su identificador y lo almacena en la variable $ScriptObj . El segundo comando ejecuta el script almacenado en esa variable.

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

Invoke-CMScript -InputObject $ScriptObj

Ejemplo 3: Pasar parámetros al script de destino

La primera línea almacena los parámetros en una tabla hash. La segunda línea ejecuta el script en el dispositivo de destino, pasando los parámetros de la tabla hash.

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

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

Parámetros

-Collection

Especifique un objeto de colección para ejecutar este script. Para obtener este objeto, use el cmdlet Get-CMCollection .

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

-CollectionId

Especifique el identificador de una colección para ejecutar este script.

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

-CollectionName

Especifique el nombre de una colección para ejecutar este script.

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

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Device

Especifique un objeto para que un dispositivo ejecute este script. Para obtener este objeto, use el cmdlet Get-CMDevice .

Type:IResultObject[]
Aliases:Devices
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-InputObject

Especifique un objeto de script que se va a ejecutar. Para obtener este objeto, use el cmdlet Get-CMScript .

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

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.

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

-ScheduleTime

Especifique una hora UTC DateTime para programar la ejecución del script para una hora posterior.

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

-ScriptGuid

Especifique el identificador del script que se va a ejecutar. El formato es un GUID estándar.

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

-ScriptParameter

Se aplica a la versión 2010 y versiones posteriores. Use este parámetro para pasar parámetros al script de destino. Especifique una tabla hash con los parámetros necesarios. Para obtener un ejemplo de uso, vea Ejemplos.

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

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object