Compartir a través de

Configuration Manager cambios en la biblioteca de cmdlets de la rama actual 1710

  • Artículo

Nota:

System Center Configuration Current Branch 1706 es la línea base para estos cambios. Consulte Configuration Manager Cambios de la biblioteca de cmdlets para la rama actual 1706 para obtener más detalles.

Cambios importantes

Actualizaciones de la biblioteca de documentación

Para obtener la documentación más reciente de la biblioteca de cmdlets, consulte Referencia del módulo ConfigurationManager.

Cmdlets quitados

Ya no se admiten los siguientes cmdlets y se han quitado:

  • Invoke-CMAmtProvisioningDiscovery
  • New-CMAmtProvisioningAccount
  • Set-CMPowerControl

Cmdlets en desuso

  • Invoke-CMEndpointProtectionScan y Save-CMEndpointProtectionDefinition han sido reemplazados por Invoke-CMClientAction.

Deshabilitar la creación automática de PSDrive

Cuando se carga el módulo ConfigurationManager.psd1, PowerShell intenta crear automáticamente una conexión al último proveedor de SMS al que se accedió mediante la consola de Configuration Manager. En algunos escenarios, es posible que este comportamiento no sea deseable. Se ha agregado una clave del Registro por usuario que puede deshabilitar este comportamiento y requerir la creación manual de unidades. Para configurar esto, use la clave del Registro: HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell y establezca el valor DisableCMDriveAutoCreate en un DWORD de 1 (la creación automática de la unidad está deshabilitada) o 0 (comportamiento predeterminado). La eliminación DisableCMDriveAutoCreate también habilita el comportamiento predeterminado.

Nota:

Cuando la creación automática de unidades está deshabilitada, la consola de Configuration Manager puede notificar un error al iniciar una ventana de PowerShell.

Problemas conocidos

Estos son problemas conocidos con la biblioteca de cmdlets que no se resuelven en esta versión.

Get-CMAadConditionalAccessPolicy y Set-CMAadConditionalAccessPolicy

El entorno de PowerShell de 64 bits es necesario para estos cmdlets.

Solución alternativa

  • Ninguno

Import-CMSecurityRole

El cmdlet puede producir un error de DirectoryNotFoundException al buscar el archivo SecuredRoles.xsd.

Solución alternativa

Asegúrese de que Import-Module se llama al ConfigurationManager.psd1 archivo y no a la ruta de acceso lógica o al nombre del módulo.

Get-CMSiteUpdateInstallStatus

El cmdlet puede producir un error WqlQueryException.

Solución alternativa

  • Use Invoke-CMWmiQuery para consultar directamente la clase SMS_CM_UpdatePackTopLevelMonitoring.
Ejemplo
# Note: The PackageGuid value can be determined by running Get-CMSiteUpdateInstallStatus -Verbose and viewing the query details.
Invoke-CMWmiQuery "SELECT * FROM SMS_UpdatePackTopLevelMonitoring WHERE PackageGuid='...' ORDER BY StageId ASC"

Set-CMSoftwareUpdatePoint

Es posible que los cambios en la programación no se reflejen en la consola de Configuration Manager aunque se haya cambiado el objeto proveedor de SMS subyacente.

Solución alternativa

Cierre y vuelva a iniciar la consola de Configuration Manager.

Cmdlets nuevos

Estos son cmdlets recién agregados para esta versión que agregan nueva funcionalidad o mejoran la funcionalidad de los cmdlets existentes.

Cmdlets de asociación de dispositivos

Get-CMResultantCollection obtendrá las colecciones asociadas a un dispositivo. Get-CMResultantDeployment obtendrá las implementaciones destinadas a un dispositivo.

Administración de clases de inventario de cliente

Se han agregado nuevos cmdlets para admitir la modificación de las clases de inventario usadas para el inventario de cliente.

  • Get-CMInventoryClass
  • New-CMInventoryReportClass

Secuencias de tareas

Se han agregado nuevos cmdlets para admitir la modificación de los pasos de secuencia de tareas.

  • Comandos de secuencia de tareas (se admiten los verbos Get, New, Remove y Set)
    • CMTaskSequenceStepApplyOperatingSystem
    • CMTaskSequenceStepApplyWindowsSetting

Seguimiento y recuperación de recursos (BETA)

Se han agregado nuevos cmdlets para admitir el seguimiento de objetos de proveedor de SMS usados por el entorno de ejecución de PowerShell y para limpiar estos recursos cuando ya no se necesiten.

  • Disconnect-CMTrackedObject
  • Start-CMObjectTracking
  • Stop-CMObjectTracking

Cuando Start-CMObjectTracking se ejecuta, el entorno de ejecución de PowerShell realizará un seguimiento de IResultObject los objetos creados por los cmdlets de la biblioteca de cmdlets. Los cmdlets que no se limpian manualmente con .Dispose() se pueden reclamar mediante el uso Disconnect-CMTrackedObject de en un objeto individual.

Ejemplo

# Reclaim all tracked objects
$o | Disconnect-CMTrackedObject```), or ```Disconnect-CMTrackedObject -All

Tenga en cuenta que una vez reclamado un objeto, ya no se puede reutilizar ni pasar a otro cmdlet a través de la canalización de objetos.

Stop-CMObjectTracking se puede usar para desactivar el seguimiento de objetos. Tenga en cuenta que los objetos asignados anteriormente permanecerán activos.

Los recursos no reclamados pueden provocar errores de infracción de cuota generados por el proveedor de SMS. Estos problemas suelen manifestarse al trabajar con conjuntos muy grandes de objetos de proveedor de SMS o en entornos de ejecución muy largos

Nota:

Se trata de una característica experimental y puede estar sujeta a cambios o eliminaciones en una versión futura. Esta característica está habilitada y no está habilitada de forma predeterminada.

Cambios en el cmdlet

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

Configuración de cumplimiento y cmdlets de reglas

Errores corregidos

Es posible que el valor RuleDescription no se aplique a la regla. (Cmdlets que admiten la creación o modificación de reglas)

No se puede establecer el valor de la clave del Registro "default" (Add/Set-CMComplianceSettingRegistryKeyValue, New-CMDetectionClauseRegistryKeyValue).

Se puede generar NullReferenceException (New-CMComplianceRuleAssembly)

Falta compatibilidad con DataType (Add-CMComplientSettingREgistryKeyValue)

Add-CMApplicationCatalogWebsitePoint

Errores corregidos

Se ha mejorado el control de errores y la generación de informes.

Add/Set-CMDataWarehouseServicePoint

Cambios no importantes

DataWarehouseSqlPort admite el valor de puerto del 1 al 65535. El parámetro DaysOfWeek ahora admite el valor de Daily.

Add/Set-CMExchangeServer

Errores corregidos

Es posible que el valor del parámetro EmailAddress no se aplique a la configuración del servidor Exchange.

Add-CMMsiDeploymentType

Errores corregidos

El parámetro ContentLocation es necesario cuando se usa la detección de scripts. Se agregaron nuevos parámetros UninstallContentLocation y UninstallOption .

Cambios no importantes

Validación mejorada del parámetro ProductCode .

Add-CMScriptDeploymentType

Cambios no importantes

Validación mejorada del parámetro ProductCode . Se agregaron nuevos parámetros UninstallContentLocation y UninstallOption .

Get-CMDeploymentTypeDependencyGroup

Cambios no importantes

El cmdlet ahora admite el valor canalizado de Get-CMDeploymentType.

Get-CMSiteStatusMessage

Errores corregidos

No todos los mensajes se devuelven al filtrar con el parámetro Severity .

Invoke-CMClientAction (anteriormente Invoke-CMClientNotification)

Cambios no importantes

Parámetro ActionType que acepta todos los tipos de notificación de cliente.

Nota:

RequestScriptExecution no se admite en este momento.

Avisos de desuso

NotificationType se ha reemplazado por ActionType.

New-CM*Deployment

Errores corregidos

El cmdlet permite combinar los parámetros CollectionId, CollectionName y Collection , lo que puede dar lugar a un comportamiento indefinido.

New-CMBootableMedia

Errores corregidos

No se pueden crear medios como SiteBased.

New-CMWirelessProfile

Errores corregidos

El cmdlet no se puede ejecutar en un entorno de PowerShell de 64 bits.

El cmdlet puede devolver un error si se especifica un valor para el parámetro ClientCertificate .

Remove-CMCorpOwnedDevice

Errores corregidos

No se puede quitar el dispositivo cuando se usa el objeto canalizado.

El nombre del dispositivo no se notifica cuando se usa WhatIf o Confirm.

Remove-CMStateMigrationPoint

Cambios importantes

Se requerirá confirmación adicional si hay datos de usuario almacenados en el punto de migración de estado. Nota: Force omitirá esta confirmación.

Save-CMSoftwareUpdate

Cambios no importantes

Se han agregado los parámetros RetryCount y RetryDelaySec para volver a intentar descargas después de un error.

Set-CMAccessAccount

Errores corregidos

Es posible que PassThru no devuelva un objeto actualizado.

Set-CMAntimalwarePolicy

Errores corregidos

No se pueden usar caracteres comodín con el parámetro AddExcludedFilePath .

No se puede configurar FallbackOrder para una directiva determinada

Cambios no importantes

Se han agregado nuevos parámetros para administrar listas de amenazas: AddThreat, RemoveThreat y CleanThreat. AddThreat acepta una tabla hash con la clave como nombre y el valor es de tipo Microsoft.ConfigurationManagement.Cmdlets.EP.Commands.DefaultActionMediumAndLowType.

Avisos de desuso

Los parámetros ThreatName e OverrideAction se han reemplazado por AddThreat, RemoveThreat y CleanThreat.

Set-CMClientSettingComputerAgent

Avisos de desuso

Parámetro HealthAttestationUrl , ya que el producto ya no lo usa.

Set-CMClientSettingHardwareInventory

Cambios no importantes

Los parámetros AddInventoryReportClass, CleanInventoryReportClass y RemoveInventoryReportClass admiten la modificación del inventario de hardware recopilado por los clientes.

Set-CMMsiDeploymentType

Cambios no importantes

Validación mejorada del parámetro ProductCode .

Set-CMScriptDeployment

Errores corregidos

Es posible que el objeto Application del proveedor de SMS no se desbloquee automáticamente si se produce un error en el cmdlet que impide modificaciones adicionales hasta que expire el bloqueo.

Set-CMScriptDeploymentType

Cambios no importantes

Validación mejorada del parámetro ProductCode .

Set-CMSoftwareUpdatePointComponent

Cambios no importantes

Se ha agregado el nuevo parámetro ContentFileOption para configurar el comportamiento de descarga de actualizaciones.

Set-CMSiteMaintenanceTask

Cambios no importantes

Informes de errores mejorados

Set-CMWirelessProfile

Errores corregidos

El cmdlet no se puede ejecutar en un entorno de PowerShell de 64 bits.

Se puede producir un error DesajustePSTypeName al usar la canalización de objetos.

ProxyAddress y ProxyPort no se validan con las mismas reglas que la consola de Configuration Manager.

La especificación de ProxyAddress sin ProxyPort puede hacer que se cree una configuración no válida.

SecurityAuthentication se puede cambiar con configuraciones que no admiten esto.

EapType debe combinarse con SecurityAuthentication incluso cuando este último no cambia.

Cambios no importantes

Se han agregado los parámetros RootCertificate, ClientCertificate y RememberCredentials .

Funcionalidad mejorada para configurar una directiva inalámbrica MSCHAPv2.

Sync-CMSoftwareUpdate

Cambios no importantes

El cmdlet ya no requiere que se especifique ningún parámetro.

Nota:

Cuando no se define ningún parámetro, -ForceSync $true se implica.