Set-CMPackage

Módulo:

ConfigurationManager

Modificar un paquete.

Syntax

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 los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\> . Para obtener más información, vea getting started.

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: Cambiar la ruta de origen del paquete

El primer comando obtiene el paquete que tiene el identificador ST120001y 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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Boolean
Aliases:	ShareContent, CopyToPackageShareOnDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Description

Especifique una descripción opcional del paquete para ayudarle a identificarlo. Puede usar un máximo de 128 caracteres.

Type:	String
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPoint

Esta opción está en desuso. Establece la propiedad ForcedDisconnectEnabled del paquete de controladores.

Type:	Boolean
Aliases:	ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointMins

Esta opción está en desuso. Establece la propiedad ForcedDisconnectDelay del paquete de controladores.

Type:	UInt32
Aliases:	ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointRetry

Esta opción está en desuso. Establece la propiedad ForcedDisconnectNumRetries del paquete de controladores.

Type:	UInt32
Aliases:	ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributionPointUpdateSchedule

Use este parámetro para actualizar los puntos de distribución en una programación. Para obtener un objeto schedule, use el cmdlet New-CMSchedule.

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

-EnableBinaryDeltaReplication

Establezca este parámetro en $true para habilitar la replicación diferencial binaria (BDR). Para obtener más información, vea Conceptos fundamentales para la administración de contenido en Configuration Manager.

Type:	Boolean
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Especifique el identificador de un paquete que se debe configurar. Este valor es un identificador de paquete estándar, por ejemplo: XYZ00020 .

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

-InputObject

Especifique un objeto de paquete que se debe configurar. Para obtener este objeto, use el cmdlet Get-CMPackage.

Type:	IResultObject
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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 de idioma. Para identificar un paquete, Configuration Manager usa los parámetros Language, Manufacturer, Namey Version. Por ejemplo, puede tener una versión en inglés y una versión en alemán del mismo paquete.

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

-Manufacturer

Especifique el nombre del fabricante del software. Puede usar un máximo de 32 caracteres. Para identificar un paquete, Configuration Manager usa los parámetros Language, Manufacturer, Namey Version.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 Status MIF Functions.

Si establece este parámetro, cuando el cliente ejecuta la implementación, el cliente de Configuration Manager busca en el directorio o en el directorio el archivo MIF de estado de instalación %TEMP% %windir% 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 entre mayúsculas y minúsculas de los valores especificados para MifName, MifPublishery MifVersion con los valores que especifica el archivo MIF. Si el cliente encuentra una coincidencia, usa el estado que el archivo MIF especifica como el estado de instalación del programa. Si no encuentra una coincidencia, o si 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.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-MifPublisher

Especifique el editor de software del paquete para la coincidencia de MIF, hasta 32 caracteres. Para obtener más información, vea el parámetro MifFileName.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-MulticastAllow

Establezca este parámetro en $true permitir que este paquete se transfiera a través de multidifusión. Para obtener más información, vea Use multicast to deploy Windows over the network with Configuration Manager.

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

-MulticastEncrypt

Si habilita MulticastAllow, establezca este parámetro en $true para cifrar paquetes de multidifusión.

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

-MulticastTransferOnly

Si habilita MulticastAllow, establezca este parámetro en $true transferir solo este paquete de controladores a través de multidifusión.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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, Namey Version.

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

-NewName

Use este parámetro para cambiar el nombre de un paquete.

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

-PassThru

Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, es posible que este cmdlet no genere ningún resultado.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 necesita ejecutar el programa, incluidos los scripts.

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

-PersistContentInCache

Si no desea que el contenido de este paquete salga de la memoria caché del cliente para dar espacio a otro contenido, establezca este parámetro en $true para conservarlo en la memoria caché del cliente.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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: descargar solo cambios de contenido en el punto de distribución
• OnDemand: descarga automáticamente contenido cuando los paquetes se asignan a puntos de distribución

Para obtener más información, vea Use prestaged content.

Type:	PrestageBehavior
Accepted values:	ManualCopy, DownloadDelta, OnDemand
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

Especifique el orden en que el sitio envía el contenido a otros sitios y los puntos de distribución de este sitio.

El sitio envía contenido de alta prioridad antes de paquetes con prioridad normal o baja. Los paquetes con la misma prioridad se envían en el orden en que se crean.

Type:	Priorities
Aliases:	DistributionPriority
Accepted values:	High, Normal, Low
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SendToPreferredDistributionPoint

Si desea habilitar la distribución de contenido a petición en los 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, vea On-demand content distribution.

Type:	Boolean
Aliases:	SendToPreferredDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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, Namey Version.

Type:	String
Position:	Named
Default value:	None
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:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object

Vínculos relacionados

• Export-CMPackage
• Get-CMPackage
• Import-CMPackage
• New-CMPackage
• Remove-CMPackage
• Paquetes y programas en Configuration Manager