Set-CMPackage
Modificar un paquete.
Sintaxis
Set-CMPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetry <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-EnableBinaryDeltaReplication <Boolean>]
[-InputObject] <IResultObject>
[-Language <String>]
[-Manufacturer <String>]
[-MifFileName <String>]
[-MifName <String>]
[-MifPublisher <String>]
[-MifVersion <String>]
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
[-NewName <String>]
[-PassThru]
[-Path <String>]
[-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priorities>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetry <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-EnableBinaryDeltaReplication <Boolean>]
-Id <String>
[-Language <String>]
[-Manufacturer <String>]
[-MifFileName <String>]
[-MifName <String>]
[-MifPublisher <String>]
[-MifVersion <String>]
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
[-NewName <String>]
[-PassThru]
[-Path <String>]
[-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priorities>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetry <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-EnableBinaryDeltaReplication <Boolean>]
[-Language <String>]
[-Manufacturer <String>]
[-MifFileName <String>]
[-MifName <String>]
[-MifPublisher <String>]
[-MifVersion <String>]
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-Path <String>]
[-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priorities>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use este cmdlet para cambiar la configuración de un paquete. Para obtener más información, vea Paquetes y programas en 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: Cambiar el nombre de un paquete y agregar una descripción
Este comando cambia el nombre del paquete que tiene el identificador ST120001 a ScriptsPackage02 y agrega una descripción.
Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."
Ejemplo 2: Cambio de la ruta de acceso de origen del paquete
El primer comando obtiene el paquete que tiene el identificador ST120001 y almacena los resultados en la variable $Pkg . El segundo comando cambia la ruta de acceso de origen del paquete.
$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"
Parámetros
-Confirm
Agregue este parámetro para solicitar confirmación antes de que se ejecute el cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-CopyToPackageShareOnDistributionPoint
Los clientes siempre pueden descargar un paquete desde un punto de distribución. Si establece este parámetro en $true, el sitio lo pone a disposición a través de un recurso compartido de red con nombre en puntos de distribución. Use CustomPackageShareName para especificar un nombre de recurso compartido personalizado.
Al habilitar esta opción, se requiere más espacio en los puntos de distribución. Se aplica a todos los puntos de distribución a los que se distribuye este paquete.
Tipo: | Boolean |
Alias: | ShareContent, CopyToPackageShareOnDistributionPoints |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-CustomPackageShareName
Si habilita CopyToPackageShareOnDistributionPoint, puede usar este parámetro para personalizar el nombre del recurso compartido. La longitud máxima es de 127 caracteres y no puede incluir ninguno de los siguientes caracteres: " / [ ] : | < > + = ; , ? *
. Puede especificar un nombre de recurso compartido y un nombre de carpeta, pero el máximo para cada uno es de 80 caracteres. Por ejemplo, ShareName\FolderName
.
Tipo: | String |
Alias: | ShareName |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Description
Especifique una descripción opcional del paquete para ayudarle a identificarlo. Puede usar un máximo de 128 caracteres.
Tipo: | String |
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 |
-DisconnectUserFromDistributionPoint
Esta opción está en desuso. Establece la propiedad ForcedDisconnectEnabled del paquete del controlador.
Tipo: | Boolean |
Alias: | ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DisconnectUserFromDistributionPointMins
Esta opción está en desuso. Establece la propiedad ForcedDisconnectDelay del paquete de controladores.
Tipo: | UInt32 |
Alias: | ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DisconnectUserFromDistributionPointRetry
Esta opción está en desuso. Establece la propiedad ForcedDisconnectNumRetries del paquete del controlador.
Tipo: | UInt32 |
Alias: | ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DistributionPointUpdateSchedule
Use este parámetro para actualizar los puntos de distribución según una programación. Para obtener un objeto de programación, use el cmdlet New-CMSchedule .
Tipo: | IResultObject |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-EnableBinaryDeltaReplication
Establezca este parámetro en $true para habilitar la replicación diferencial binaria (BDR). Para obtener más información, consulte Conceptos fundamentales para la administración de contenido en Configuration Manager.
Tipo: | Boolean |
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 |
-Id
Especifique el identificador de un paquete que se va a configurar. Este valor es un identificador de paquete estándar, por ejemplo: XYZ00020
.
Tipo: | String |
Alias: | PackageId |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-InputObject
Especifique un objeto de paquete que se va a configurar. Para obtener este objeto, use el cmdlet Get-CMPackage .
Tipo: | IResultObject |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Language
Especifique una cadena de idioma para el paquete. Puede usar un máximo de 32 caracteres en un formato que elija usar para identificar la versión del idioma. Para identificar un paquete, Configuration Manager usa los parámetros Language, Manufacturer, Name y Version . Por ejemplo, puede tener una versión en inglés y una versión en alemán del mismo paquete.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Manufacturer
Especifique el nombre del fabricante para el software. Puede usar un máximo de 32 caracteres. Para identificar un paquete, Configuration Manager usa los parámetros Language, Manufacturer, Name y Version .
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-MifFileName
Especifique el nombre del archivo de formato de información de administración (MIF) que contiene el estado del paquete. La extensión de nombre de archivo debe ser .mif
. Use un archivo MIF de estado para generar informes de estado detallados. Para generar un archivo MIF de estado, la aplicación debe llamar a la función InstallStatusMIF. Para obtener más información, vea Funciones de MIF de estado.
Si establece este parámetro, cuando el cliente ejecuta la implementación, el cliente de Configuration Manager busca en el %TEMP%
directorio o en el %windir%
directorio el archivo MIF de estado de instalación que especifique. El estado de instalación indica si el programa se ejecutó correctamente.
Si el cliente no encuentra el archivo, busca todos los archivos MIF en esos directorios. Realiza una comparación sin distinción entre mayúsculas y minúsculas de los valores especificados para MifName, MifPublisher y MifVersion con los valores especificados por el archivo MIF. Si el cliente encuentra una coincidencia, usa el estado que especifica el archivo MIF como estado de instalación del programa. Si no encuentra una coincidencia o no especifica MifFileName, el cliente usa el código de salida del programa para establecer el estado de instalación del programa. Un código de salida de cero indica que el programa se ejecutó correctamente. Cualquier otro valor indica códigos de error específicos de la aplicación.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-MifName
Especifique el nombre del paquete para la coincidencia de MIF, hasta 50 caracteres. Para obtener más información, vea el parámetro MifFileName .
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-MifPublisher
Especifique el publicador de software del paquete para la coincidencia de MIF, hasta 32 caracteres. Para obtener más información, vea el parámetro MifFileName .
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-MifVersion
Especifique el número de versión del paquete para la coincidencia de MIF, hasta 32 caracteres. Para obtener más información, vea el parámetro MifFileName .
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-MulticastAllow
Establezca este parámetro en $true para permitir que este paquete se transfiera a través de multidifusión. Para obtener más información, consulte Uso de multidifusión para implementar Windows a través de la red con Configuration Manager.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-MulticastEncrypt
Si habilita MulticastAllow, establezca este parámetro en $true para cifrar los paquetes de multidifusión.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-MulticastTransferOnly
Si habilita MulticastAllow, establezca este parámetro en $true para transferir solo este paquete de controladores a través de multidifusión.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Name
Especifique un nombre de paquete. Puede usar un máximo de 250 caracteres. Para identificar un paquete, Configuration Manager usa los parámetros Language, Manufacturer, Name y Version .
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NewName
Use este parámetro para cambiar el nombre de un paquete.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PassThru
Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Path
Si el paquete contiene archivos de origen, especifique la ubicación de los archivos. Puede especificar una ruta de acceso local completa en el servidor de sitio o una ruta de acceso de red. Asegúrese de que esta ubicación contiene todos los archivos y subdirectorios que el programa necesita ejecutar, incluidos los scripts.
Tipo: | String |
Alias: | PackageSourcePath |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PersistContentInCache
Si no desea que el contenido de este paquete se agote de la memoria caché del cliente para dejar espacio a otro contenido, establezca este parámetro en $true conservarlo en la memoria caché del cliente.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PrestageBehavior
Especifique el comportamiento al habilitar un punto de distribución para el contenido preconfigurado:
-
ManualCopy
: copie manualmente el contenido de este paquete en el punto de distribución. -
DownloadDelta
: descargue solo los cambios de contenido en el punto de distribución. -
OnDemand
: descarga automática del contenido cuando se asignan paquetes a puntos de distribución
Para obtener más información, consulte Uso de contenido preconfigurado.
Tipo: | PrestageBehavior |
Valores aceptados: | ManualCopy, DownloadDelta, OnDemand |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Priority
Especifique el orden en que el sitio envía el contenido a otros sitios y a los puntos de distribución de este sitio.
El sitio envía contenido de alta prioridad antes que los paquetes con prioridad normal o baja. Los paquetes con la misma prioridad se envían en el orden en que se crean.
Tipo: | Priorities |
Alias: | DistributionPriority |
Valores aceptados: | High, Normal, Low |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SendToPreferredDistributionPoint
Si desea habilitar la distribución de contenido a petición en puntos de distribución preferidos, establezca este parámetro en $true. Al habilitar esta configuración, si un cliente solicita el contenido del paquete y el contenido no está disponible en ningún punto de distribución, el punto de administración distribuye el contenido. Para obtener más información, consulte Distribución de contenido a petición.
Tipo: | Boolean |
Alias: | SendToPreferredDistributionPoints |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Version
Especifique un número de versión para el software. La longitud máxima de esta cadena es de 32 caracteres. Para identificar un paquete, Configuration Manager usa los parámetros Language, Manufacturer, Name y Version .
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
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: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
System.Object