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

  • Artículo

Se aplica a: Configuration Manager (rama actual)

Estas notas de la versión resumen los cambios en la Administrador de configuración de cmdlets de la versión 2103.

Nota

Administrador de configuración versión 2010 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 2010.

Problema conocido con la ayuda de PowerShell actualizable

A partir de la versión 2010, puede usar el cmdlet Update-Help para descargar la información más reciente del módulo PowerShell de Configuration Manager.

En la versión 2103, la estructura del módulo de PowerShell cambió de 29 archivos DLL a dos. Los archivos de ayuda XML de PowerShell están asociados con el archivo DLL de los cmdlets. Por lo tanto, el contenido de la ayuda de la versión 2010 no es compatible con una consola de la versión 2103 y el contenido de la ayuda de la versión 2103 no es compatible con una consola de la versión 2010.

Debido a este cambio en la estructura y publicación del contenido actualizable con la versión 2103, no use Update-Help en un sitio de la versión 2010. Actualice el sitio a la versión 2103 y, a continuación, actualice el contenido de la ayuda local.

El cmdlet descargará el contenido correctamente en la consola de la versión 2010, pero Get-Help solo devolverá la información de uso predeterminada. Este comportamiento se debe a que PowerShell no puede encontrar la información del cmdlet en el archivo XML correcto, que ahora es diferente. Antes del lanzamiento de la versión 2103, si usó Update-Help con un sitio de la versión 2010, puede seguir usando Get-Help ahora.

Del mismo modo, si usó Update-Help en un sitio de la versión 2010, después de actualizar a la versión 2103, ejecute Update-Help de nuevo para obtener la versión compatible del contenido de ayuda. De lo contrario, Get-Help solo devolverá información de uso predeterminada.

Nota

Este problema es único para la versión 2010. Debido a cómo cambió la estructura, no debería ser un problema para versiones posteriores.

Módulo de PowerShell

Si la consola de Configuration Manager del dispositivo aún no se ha conectado a un sitio, si se importa manualmente el módulo ConfigurationManager, se creará una unidad de PowerShell para el sitio basándose en el proveedor de SMS predeterminado.

A partir de la versión 2103, el módulo de PowerShell ConfigurationManager requiere Microsoft .NET versión 4.7.2 o posterior.

Cmdlets que no admiten la versión 7 de PowerShell

Aunque los cmdlets de Configuration Manager proporcionan compatibilidad general con la versión 7 de PowerShell, los siguientes cmdlets no admiten PowerShell 7:

  • Import-CMPackage
  • Import-CMDriverPackage
  • Import-CMTaskSequence
  • Export-CMPackage
  • Export-CMDriverPackage
  • Export-CMTaskSequence

Necesitan .NET Framework en lugar de .NET Core que se usa con la versión 7 de PowerShell.

A partir de la versión 2103, si intenta usar estos cmdlets en una sesión de la versión 7 de PowerShell, se producirá el siguiente error: This cmdlet only supports the ".NET Framework" runtime.

Nuevos cmdlets

Cambios en el cmdlet

Se han realizado los siguientes cambios en los cmdlets existentes en esta versión. Los cambios pueden ser nuevas funcionalidades, correcciones de errores o desuso. 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.

Soporte técnico rápido

Los siguientes cmdlets ahora admiten el parámetro Fast. Use este parámetro para no actualizar automáticamente las propiedades diferidas. Las propiedades diferidas contienen valores que son relativamente ineficaces en lo que a su recuperación se refiere. Obtener estas propiedades puede provocar más tráfico de red y afectar al rendimiento de los cmdlets.

  • Get-CMAlert
  • Get-CMAlertSubscription
  • Get-CMBaseline
  • Get-CMBaselineDeployment
  • Get-CMBaselineDeploymentStatus
  • Get-CMClientCertificatePfx
  • Get-CMComplianceRule
  • Get-CMComplianceSetting
  • Get-CMConfigurationPlatform
  • Get-CMConfigurationPolicyDeployment
  • Get-CMDriver
  • Get-CMDriverPackage
  • Get-CMTaskSequence
  • Get-CMTaskSequenceDeployment

Add-CMFallbackStatusPoint

Cambios secundarios

Se corrigió un nombre de parámetro incoherente.

Copy-CMCollection

Cambios secundarios

Se ha corregido la validación con el parámetro NewName para que se alinee con la consola.

Get-CMDeploymentStatusDetails

Cambios secundarios

  • Se corrigió un problema de validación de tipo de objeto de entrada para tipos como SMS_DCMDeploymentErrorStatus, SMS_DCMDeploymentNonCompliantStatus y SMS_DCMDeploymentCompliantStatus.
  • Se corrigió un problema de tipo de clase no válida de salida al cambiar el tipo de objeto de salida SMS_AppDeploymentRequirementsNotMetStatus a SMS_AppDeploymentRequirementsNotMetAssetDetails.
  • Se cambió el tipo de objeto de salida de SMS_AppDeploymentAssetDetails a SMS_AppDeploymentErrorAssetDetails para obtener más detalles del error.
  • Se agregó un tipo de objeto de entrada SMS_UpdateDeploymentSummary para que este cmdlet pueda obtener detalles de implementación de actualización. Al pasar el resultado de Get-CMSoftwareUpdateDeploymentStatus a Get-CMDeploymentStatusDetails, devuelve los detalles de implementación de SMS_SUMDeploymentAssetDetails.

Get-CMDriver

Cambios secundarios

Se ha agregado la capacidad de filtrar contenido por el parámetro AdministrativeCategory.

$category1 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 1'
$category2 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 2'
$categories = $category1,$category2

Get-CMDriver -AdministrativeCategory $categories

Get-CMPackage

Cambios secundarios

Se ha agregado el parámetro PackageType para recuperar un tipo de paquete específico.

Get-CMSoftwareUpdateDeployment

Cambios secundarios

Se corrigió un problema al implementar las actualizaciones sin ningún paquete.

New-CMApplication

Errores que se han corregido

Se ha corregido un problema de visualización del Centro de software al instalar aplicaciones creadas con el formato de hora "AAAA/MM/dd".

New-CMCertificateProfileScep

Errores que se han corregido

Se corrigió un problema para el parámetro SanType.

New-CMCollection

Cambios secundarios

Se ha corregido la validación con el parámetro Name para que se alinee con la consola.

New-CMOperatingSystemImage

Cambios secundarios

Parámetro Index agregado. Al agregar este parámetro, el sitio extrae una sola imagen de índice de una imagen de varios índices. Después, coloca la nueva imagen en la misma carpeta de origen que la imagen original.

New-CMOperatingSystemInstaller

Cambios secundarios

Parámetro Index agregado. Al agregar este parámetro, el sitio reemplaza la imagen de varios índices actual por una nueva imagen de índice único.

New-CMTSRule

Cambios secundarios

El parámetro ReferencedVariableOperator tiene otro valor posible: NotLike .

New-CMTSStepConditionVariable

Cambios secundarios

Parameter OperatorType tiene otro valor posible: NotLike

New-CMSoftwareUpdateAutoDeploymentRule

Cambios importantes

Se corrigió un problema para el parámetro O365LanguageSelection. Ahora debe especificar un idioma con un nombre de país. Este cambio alinea este parámetro con las opciones de la consola de Configuration Manager. Por ejemplo: -O365LanguageSelection "English (United States)"

Set-CMCertificateProfileScep

Errores que se han corregido

Se corrigió un problema para el parámetro SanType.

Set-CMClientPushInstallation

Cambios secundarios

Se ha agregado el parámetro AllownNTLMFallback para habilitar la reserva NTLM.

Set-CMCollection

Cambios secundarios

Se ha corregido la validación con el parámetro NewName para que se alinee con la consola.

Set-CMEmailProfile

Cambios secundarios

  • Se corrigió un problema con el parámetro NewName al especificar sAMAccountName como nombre de usuario de la cuenta.
  • Se corrigió un problema de parámetro al resolver DomainName.

Set-CMFallbackStatusPoint

Cambios secundarios

Se corrigió un nombre de parámetro incoherente.

Set-CMThirdPartyUpdateCatalog

Cambios secundarios

Se han agregado los parámetros CategoryNamePublishOption y CategoryIdPublishOption. Use estos parámetros para establecer la opción de publicación de categorías al suscribirse a un catálogo v3.

$id = "5768207d-6c40-465b-ad65-50501661368f"
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$idOptionPair = @{$id = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName 'pmp' -CategoryIdPublishOption $idOptionPair -Subscribe -Force

$name = "2BrightSparks"
$name1 = "8x8, Inc."
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$nameOptionPair = @{$name = $option; $name1 = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName pmp -CategoryNamePublishOption $nameOptionPair -Subscribe -Force

Set-CMThirdPartyUpdateCategory

Cambios secundarios

Se ha corregido una incidencia con el parámetro PublishOption establecido en FullContent.

Set-CMTSStep*

Por ejemplo, Set-CMTSStepApplyDataImage y los otros 34 cmdlets similares.

Cambios secundarios

Parameter OperatorType tiene otro valor posible: NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

Cambios importantes

Se corrigió un problema para el parámetro O365LanguageSelection. Ahora debe especificar un idioma con un nombre de país. Este cambio alinea este parámetro con las opciones de la consola de Configuration Manager. Por ejemplo: -O365LanguageSelection "English (United States)"

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 Administrador de configuración consola. 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.