Compartir a través de

New-CMScript

  • Referencia
Módulo:
ConfigurationManager

Cree un script de PowerShell en Configuration Manager.

Sintaxis

New-CMScript
   [-Fast]
   -ScriptFile <String>
   -ScriptName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMScript
   [-Fast]
   -ScriptName <String>
   -ScriptText <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

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

Nota:

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

Ejemplos

Ejemplo 1: Creación de un script con texto

En este ejemplo se crea un nuevo script denominado CMScript. Especifica el texto del script.

New-CMScript -ScriptName "CMScript" -ScriptText 'Write-Host "New Script"'

Ejemplo 2: Creación de un script a partir de un archivo

En este ejemplo se crea un nuevo script denominado ImportScript. Importa el script de un archivo existente en un recurso compartido de red.

New-CMScript -ScriptName "ImportScript" -ScriptFile "\\abc\importedscript.ps1" -Fast

Parámetros

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Fast

Agregue este parámetro para no actualizar automáticamente las propiedades diferidas. Las propiedades diferidas contienen valores relativamente ineficaces para recuperar. La obtención de estas propiedades puede provocar tráfico de red adicional y reducir el rendimiento del cmdlet.

Si no usa este parámetro, el cmdlet muestra una advertencia. Para deshabilitar esta advertencia, establezca $CMPSSuppressFastNotUsedCheck = $true.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ScriptFile

Especifique la ruta de acceso a un archivo de script de PowerShell (.ps1). El texto del archivo se usa para el script en Configuration Manager.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ScriptName

Especifique un nombre para el script que se va a crear.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ScriptText

Especifique el texto del script que se va a crear.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

System.Object