Administrador de configuración de cmdlets de la versión 2107

Se aplica a: Configuration Manager (rama actual)

En estas notas de la versión se resumen los cambios en la Administrador de configuración de cmdlets de la versión 2107.

Nota

Administrador de configuración versión 2103 de la rama actual es la línea de base para estos cambios. Para obtener más información, vea Administrador de configuración de la biblioteca de cmdlets para la versión 2103.

Nuevos cmdlets para tipos de implementación de aplicaciones

Administración de comportamientos de instalación para tipos de implementación de aplicaciones

Este conjunto de nuevos cmdlets es para el comportamiento de instalación del tipo de implementación de la aplicación. Para más información general sobre la característica de comportamiento de instalación, consulte Comprobar archivos ejecutables en ejecución.

Add-CMDeploymentTypeInstallBehavior

Use este cmdlet para agregar al tipo de implementación especificado los archivos ejecutables que deben cerrarse para que la instalación de la aplicación se realice correctamente.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -DisplayName "Notepad"

Para obtener más información, vea Add-CMDeploymentTypeInstallBehavior.

Get-CMDeploymentTypeInstallBehavior

Use este cmdlet para obtener del tipo de implementación especificado la lista de archivos ejecutables que deben cerrarse para que la instalación de la aplicación se realice correctamente.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Get-CMDeploymentTypeInstallBehavior -InputObject $msi_dt

Para obtener más información, vea Get-CMDeploymentTypeInstallBehavior.

Remove-CMDeploymentTypeInstallBehavior

Use este cmdlet para quitar del tipo de implementación especificado los archivos ejecutables que deben cerrarse para que la instalación de la aplicación se realice correctamente.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe"

Para obtener más información, vea Remove-CMDeploymentTypeInstallBehavior.

Set-CMDeploymentTypeInstallBehavior

Use este cmdlet para modificar los archivos ejecutables que deben cerrarse para que la instalación de la aplicación se realice correctamente.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Set-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -NewExeFileName "calc.exe" -DisplayName "Calculator"

Para obtener más información, vea Set-CMDeploymentTypeInstallBehavior.

Administración de códigos de retorno para tipos de implementación de aplicaciones

Este conjunto de nuevos cmdlets es para códigos de retorno de tipo de implementación de aplicación. Para más información general, vea Códigos de retorno del tipo de implementación.

Add-CMDeploymentTypeReturnCode

Use este cmdlet para agregar códigos de retorno a un tipo de implementación compatible.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602 -Name "User cancel" -CodeType Failure -Description "The user cancelled the installation"

Para obtener más información, vea Add-CMDeploymentTypeReturnCode.

Get-CMDeploymentTypeReturnCode

Use este cmdlet para obtener la lista de códigos de retorno del tipo de implementación especificado.

Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)" | Get-CMDeploymentTypeReturnCode

Para obtener más información, vea Get-CMDeploymentTypeReturnCode.

Remove-CMDeploymentTypeReturnCode

Use este cmdlet para eliminar los códigos de retorno del tipo de implementación especificado.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602

Para obtener más información, vea Remove-CMDeploymentTypeReturnCode.

Set-CMDeploymentTypeReturnCode

Use este cmdlet para modificar los códigos de retorno del tipo de implementación especificado.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 3010 -Name "Always reboot" -CodeType HardReboot -Description "Change soft reboot to hard reboot"

Para obtener más información, vea Set-CMDeploymentTypeReturnCode.

Otros cmdlets nuevos

Get-CMClientSettingDeployment

Use este cmdlet para obtener una implementación de un objeto de configuración de cliente personalizado. Puede usar este objeto con Remove-CMClientSettingDeployment.

Para más información sobre la configuración de cliente, vea Configuración del cliente.

$clientSetting =  Get-CMClientSetting -Name "Software Center customizations"
$clientSetting | Get-CMClientSettingDeployment

Para obtener más información, vea Get-CMClientSettingDeployment.

Get-CMDeploymentTypeDetectionClause

Use este cmdlet para obtener las cláusulas de detección del tipo de implementación especificado.

Puede usar este cmdlet para obtener una cláusula de detección de una aplicación y aplicarla a otra, por ejemplo:

$appMsi = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"

$clause1 = Get-CMDeploymentTypeDetectionClause -InputObject $appMsi

Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause1

Para obtener más información, vea Get-CMDeploymentTypeDetectionClause.

Get-CMPersistentUserSettingsGroup

Use este cmdlet para obtener la lista de la configuración de todo el sitio que ha almacenado. Esta configuración le sigue en distintos dispositivos.

Por ejemplo, las notificaciones de la consola de Configuration Manager que están activas o que ha descartado.

Para obtener más información, vea Get-CMPersistentUserSettingsGroup.

Get-CMSoftwareUpdateContentInfo

Use este cmdlet para obtener información de contenido de actualización de software.

$update = Get-CMSoftwareUpdate -ArticleId "5004237" -Fast
Get-CMSoftwareUpdateContentInfo -InputObject $update[1]

Para obtener más información, vea Get-CMSoftwareUpdateContentInfo.

Remove-CMPersistentUserSettingsGroup

Use este cmdlet para restablecer la configuración de todo el sitio.

Por ejemplo, puede restaurar las notificaciones de la consola de Configuration Manager que haya descartado. Después de ejecutar este cmdlet y reiniciar la consola de Configuration Manager, verá todas las notificaciones disponibles de nuevo.

Para obtener más información, vea Remove-CMPersistentUserSettingsGroup.

Cmdlets en desuso y eliminados

Los siguientes cmdlets para iniciar una implementación están en desuso y se pueden quitar en una versión futura:

Cmdlet en desuso Replacement
Start-CMApplicationDeploymentSimulation New-CMApplicationDeployment con el parámetro Simulation
Start-CMClientSettingDeployment New-CMClientSettingDeployment
Start-CMAntimalwarePolicyDeployment New-CMAntimalwarePolicyDeployment

Los siguientes cmdlets ya no están disponibles porque ya no se admiten las características subyacentes:

  • Add-CMApplicationCatalogWebServicePoint

  • Add-CMApplicationCatalogWebsitePoint

  • Get-CMApplicationCatalogWebServicePoint

  • Get-CMApplicationCatalogWebsitePoint

  • Remove-CMApplicationCatalogWebServicePoint

  • Remove-CMApplicationCatalogWebsitePoint

  • Set-CMApplicationCatalogWebsitePoint

  • Get-CMVhd

  • New-CMVhd

  • Remove-CMVhd

  • Set-CMVhd

Cambios en el cmdlet

Se han realizado los siguientes cambios en los cmdlets existentes en esta versión. Los cambios pueden ser nuevas funcionalidades o correcciones de errores. Algunos cambios pueden ser importantes. Si usa uno de los cmdlets o áreas de características que se enumeran en esta sección, revise detenidamente los cambios para comprender cómo pueden afectar a su uso.

Add-CMDeviceCollectionDirectMembershipRule

Para más información, consulte Add-CMDeviceCollectionDirectMembershipRule.

Errores que se han corregido

Se ha corregido un problema al intentar agregar miles de dispositivos como reglas de pertenencia directa.

Add-CMDistributionPoint

Para más información, vea Add-CMDistributionPoint.

Cambios importantes

El espacio disponible mínimo predeterminado ha cambiado de 50 MB a 500 MB.

Add-CMTaskSequenceStep

Para obtener más información, vea Add-CMTaskSequenceStep.

Cambios secundarios

Se ha quitado el parámetro StepName innecesario.

Disconnect-CMTrackedObject

Para obtener más información, vea Disconnect-CMTrackedObject.

Cambios secundarios

Se ha agregado el alias Disconnect-CMObject para este cmdlet.

Get-CMApplicationGroup

Para obtener más información, vea Get-CMApplicationGroup.

Errores que se han corregido

Se ha corregido un problema para obtener la ruta de acceso correcta del grupo de aplicaciones.

Get-CMDeploymentStatusDetails

Para obtener más información, vea Get-CMDeploymentStatusDetails.

Errores que se han corregido

Se ha corregido la condición de consulta para evitar posibles problemas de coincidencia de tipos.

Import-CMAntimalwarePolicy

Para obtener más información, vea Import-CMAntimalwarePolicy.

Cambios secundarios

Se ha agregado compatibilidad con la directiva de modo de auditoría con aplicaciones potencialmente no deseadas. Para obtener más información, vea Modo de auditoría para aplicaciones potencialmente no deseadas.

Import-CMQuery

Para obtener más información, vea Import-CMQuery.

Errores que se han corregido

Se ha corregido un problema para desbloquear la función de importación.

New-CMAdministrativeUser

Para obtener más información, vea New-CMAdministrativeUser.

Errores que se han corregido

Se ha corregido un problema cuando el nombre de usuario es me .

New-CMApplicationDeployment

Para obtener más información, vea New-CMApplicationDeployment.

Cambios secundarios

Se ha agregado el parámetro AutoCloseExecutable para habilitar la configuración de implementación de la aplicación para los comportamientos de instalación.

New-CMCloudManagementGateway

Para obtener más información, vea New-CMCloudManagementGateway.

Cambios importantes

El parámetro ServiceCertPassword ahora es obligatorio.

New-CMMigrationJob

Para obtener más información, vea New-CMMigrationJob.

Errores que se han corregido

Se ha desbloqueado la migración de objetos de implementación de distribución de software.

New-CMSecondarySite

Para obtener más información, vea New-CMSecondarySite.

Cambios importantes

Se ha cambiado el espacio disponible mínimo predeterminado de 200 MB a 500 MB.

New-CMSoftwareUpdateAutoDeploymentRule

Para obtener más información, New-CMSoftwareUpdateAutoDeploymentRule.

Errores que se han corregido

Se ha corregido un problema con el parámetro Product. Cuando hay varios productos con el mismo nombre, ahora selecciona todos ellos.

New-CMSoftwareUpdateDeployment

Para obtener más información, vea New-CMSoftwareUpdateDeployment.

Cambios secundarios

Se ha agregado el alias Description al parámetro Comment.

New-CMTaskSequence

Para más información, consulte New-CMTaskSequence.

Cambios secundarios

  • Se ha ampliado la longitud máxima del parámetro Description a 512 caracteres.

  • Se ha agregado el nuevo parámetro HighPerformance para admitir la configuración de rendimiento.

  • Se quitó el parámetro InstallationLicensingMode heredado.

  • Se ha quitado el conjunto de parámetros NewInstallOSImageVhd.

  • Se ha quitado el parámetro InstallOperatingSystemImageVhd.

New-CMTaskSequenceDeployment

Para obtener más información, vea New-CMTaskSequenceDeployment.

Errores que se han corregido

Se ha corregido un problema con los planes de energía de alto rendimiento.

New-CMTSStepApplyDriverPackage

Para obtener más información, vea New-CMTSStepApplyDriverPackage.

Cambios secundarios

Se ha agregado una condición para validar un paquete para el packageId especificado.

New-CMTSStepApplyOperatingSystem

Para más información, consulte New-CMTSStepApplyOperatingSystem.

Errores que se han corregido

Se han corregido problemas de validación con el parámetro DestinationVariable para permitir valores que empiezan por un carácter de subrayado (_).

Cambios secundarios

Se ha agregado el parámetro LayeredDriver para admitir el controlador de teclado por capas durante la implementación del sistema operativo.

New-CMTSStepUpgradeOperatingSystem

Para obtener más información, vea New-CMTSStepUpgradeOperatingSystem.

Cambios secundarios

Se ha agregado el nuevo parámetro SoftwareUpdate para especificar una actualización de características para el paso de secuencia de tareas Actualizar sistema operativo.

Publish-CMPrestageContent

Para obtener más información, vea Publish-CMPrestageContent.

Errores que se han corregido

Se ha corregido un posible problema de objeto no válido.

Remove-CMApplicationGroup

Para obtener más información, vea Remove-CMApplicationGroup.

Errores que se han corregido

Se ha corregido un problema para obtener la ruta de acceso correcta del grupo de aplicaciones al usar la canalización.

Set-CMAntimalwarePolicy

Para obtener más información, vea Set-CMAntimalwarePolicy.

Cambios secundarios

Se ha agregado el parámetro PuaProtection para admitir aplicaciones potencialmente no deseadas.

Set-CMApplicationDeployment

Para obtener más información, vea Set-CMApplicationDeployment.

Cambios secundarios

Se ha agregado el parámetro AutoCloseExecutable para habilitar la configuración de implementación de la aplicación para los comportamientos de instalación.

Set-CMClientSetting

Para obtener más información, vea Set-CMClientSetting.

Cambios secundarios

Se ha agregado un mensaje de desuso significativo para el parámetro SoftwareMetering.

Set-CMClientSettingSoftwareUpdate

Para obtener más información, vea Set-CMClientSettingSoftwareUpdate.

Cambios secundarios

Se ha agregado el parámetro EnableWsusCertPinning para admitir la anclación de certificados.

Set-CMDeploymentType

Para obtener más información, vea Set-CMDeploymentType.

Errores que se han corregido

Se ha corregido un problema con el parámetro AddRequirement para agregar nuevas reglas.

Set-CMMsiDeploymentType

Para obtener más información, vea Set-CMMsiDeploymentType.

Errores que se han corregido

Se ha actualizado el tipo de implementación según el tipo de instalador para evitar restablecer las configuraciones al cambiar la ubicación del contenido.

Cambios secundarios

Se ha agregado compatibilidad para especificar una ruta de acceso de carpeta al parámetro ContentLocation.

Set-CMTaskSequence

Para obtener más información, vea Set-CMTaskSequence.

Cambios secundarios

Se ha agregado el nuevo parámetro HighPerformance para admitir la configuración de rendimiento de la secuencia de tareas.

Set-CMTSStepApplyDriverPackage

Para obtener más información, vea Set-CMTSStepApplyDriverPackage.

Cambios secundarios

Se ha agregado una condición para validar un paquete para el packageId especificado.

Set-CMTSStepApplyOperatingSystem

Para obtener más información, vea Set-CMTSStepApplyOperatingSystem.

Errores que se han corregido

Se ha corregido un problema con el parámetro Destination.

Cambios secundarios

Se ha agregado el parámetro LayeredDriver para admitir el controlador de teclado por capas durante la implementación del sistema operativo.

Set-CMTSStepUpgradeOperatingSystem

Para obtener más información, vea Set-CMTSStepUpgradeOperatingSystem.

Cambios secundarios

Se ha agregado el nuevo parámetro SoftwareUpdate para especificar una actualización de características para el paso de secuencia de tareas Actualizar sistema operativo.

Start-CMDistributionPointUpgrade

Para obtener más información, vea Start-CMDistributionPointUpgrade.

Cambios importantes

Establezca el espacio libre mínimo predeterminado en 500 MB.

Update-CMDistributionPoint

Para obtener más información, vea Update-CMDistributionPoint.

Errores que se han corregido

Se ha corregido un problema para actualizar el contenido de las carpetas de instalación y desinstalación cuando son diferentes.

Cómo proporcionar comentarios o notificar problemas

Muchas de las correcciones y mejoras descritas en este artículo son el resultado de sus comentarios.

Para enviar comentarios, use la consola Administrador de configuración cliente. Para obtener más información, vea Comentarios para PowerShell.

Para enviar nuevas solicitudes de características, consulte el grupo de powershell Administrador de configuración en UserVoice.