Configuration Manager cambios en la biblioteca de cmdlets de la versión 1902
Se aplica a: Configuration Manager (rama actual)
Nota:
Configuration Manager versión de rama actual 1810 es la línea base de estos cambios. Para obtener más información, consulte Configuration Manager cambios de biblioteca de cmdlets para la versión 1810.
Cambios importantes
Cmdlets nuevos
Get-CMBoundaryGroupSiteSystem
Use este cmdlet para obtener el sistema de sitio en el grupo de límites especificado.
Get-CMBoundaryGroupSiteSystem -Id $boundaryGroup.GroupID
Get-CMDistributionPointDriveInfo
Use este cmdlet para obtener información de unidad de punto de distribución.
$dp = Get-CMDistributionPoint -SiteSystemServerName $ReferenceSiteSystemServerName
$dp | Get-CMDistributionPointDriveInfo
Invoke-CMAnalyzePackage
Use este cmdlet para analizar un paquete específico.
Invoke-CMAnalyzePackage -PackageName $packageName
Invoke-CMConvertPackage
Use este cmdlet para convertir un paquete específico en una aplicación.
Invoke-CMConvertPackage -PackageName $packageName
New-CMScript
Use este cmdlet para crear un nuevo script de PowerShell. Solo admite scripts que no contienen ningún parámetro.
New-CMScript -ScriptName "CMScript" -ScriptText 'Write-Host "New Script"'
New-CMScript -ScriptName "ImportScript" -ScriptFile \\abc\importedscript.ps1
Set-CMClientSettingDeliveryOptimization
Use este cmdlet para establecer la configuración de cliente para la característica Optimización de distribución.
[Default] Set-CMClientSettingDeliveryOptimization -DefaultSetting -Enable $true
[Customized] Set-CMClientSettingDeliveryOptimization -Name $ReferenceClientDeviceSettingName -Enable $true
Set-CMClientSettingWindowsAnalytics
Use este cmdlet para establecer la configuración de cliente para la característica de Windows Analytics.
[Default] Set-CMClientSettingWindowsAnalytics -DefaultSetting -Enable $true -CommercialIdKey $commercialIdKey -Win10Telemetry EnhancedLimited -EnableEarlierTelemetry $true -IEDataCollectionOption AllZones
[Customized] Set-CMClientSettingWindowsAnalytics -Name $ReferenceClientDeviceSettingName -Enable $true -CommercialIdKey $commercialIdKey -Win10Telemetry EnhancedLimited -EnableEarlierTelemetry $true -IEDataCollectionOption AllZones
Cmdlets quitados
Ninguno
Cmdlets en desuso
Ninguno
Problemas conocidos
Los siguientes elementos son problemas conocidos con la biblioteca de cmdlets que no se resuelven en esta versión.
Get-CMAadConditionalAccessPolicy y Set-CMAadConditionalAccessPolicy
Estos cmdlets requieren un entorno de PowerShell de 64 bits.
Solución alternativa
- Ninguno
Import-CMSecurityRole
El cmdlet puede producir un error de DirectoryNotFoundException al buscar el archivo SecuredRoles.xsd
.
Solución alternativa
- Llame al
Import-Module
ConfigurationManager.psd1
archivo y no a la ruta de acceso lógica ni al nombre del módulo.
Set-CMSoftwareUpdatePoint
Es posible que los cambios en la programación no se muestren 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.
Seguimiento y recuperación de recursos (beta)
Esta versión agrega 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
Al ejecutar Start-CMObjectTracking
, el entorno de ejecución de PowerShell realiza un seguimiento de los IResultObject
objetos creados por los cmdlets de la biblioteca de cmdlets. En el caso de los cmdlets que no se limpian manualmente con .Dispose()
, reclamelos mediante Disconnect-CMTrackedObject
un objeto individual.
Ejemplo
# Reclaim a single tracked object
$o | Disconnect-CMTrackedObject
# Reclaim all tracked objects
Disconnect-CMTrackedObject -All
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. Los objetos asignados anteriormente permanecen activos.
Los recursos no reclamados pueden hacer que el proveedor de SMS genere errores de infracción de cuota. Estos problemas de cuota suelen manifestarse al trabajar con grandes conjuntos de objetos de proveedor de SMS o en entornos de larga duración.
Nota:
Esta característica es experimental y puede estar sujeta a cambios o eliminaciones en una versión futura. Está habilitada y no está habilitada de forma predeterminada.
Cambios en el cmdlet
Se han realizado los siguientes cambios en los cmdlets existentes en esta versión. Los cambios pueden ser nuevas funciones, correcciones de errores o desuso. Algunos cambios pueden estar rompiendo. 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.
Add-CMDeviceAffinityToUser
Errores corregidos
- Add/Remove-CMDeviceAffinityToUser -UserId/-UserName necesita usar "-DeviceId/-DeviceName" juntos.
Cambios no importantes
- Se agregó la comprobación de parámetros para -DeviceID y -DeviceName, el usuario debe especificar al menos uno de ellos.
Add-CMDeviceCollectionDirectMembershipRule
Errores corregidos
- Cuando se agrega el mismo recurso a la misma colección mediante el comando "Add-CMDeviceCollectionDirectMembershipRule" en PowerShell, se muestra una advertencia en blanco "WARNING: " y no se produce el error "Ya existe un objeto con el nombre especificado".
Cambios no importantes
- Se ha agregado un recurso que falta.
Add-CMDistributionPoint
Cambios no importantes
- Se ha agregado el parámetro "-EnableLedbat" para habilitar o deshabilitar LEDBAT en DP.
Add-CMScriptDeploymentType
Errores corregidos
- Add-CMScriptDeploymentType no alinearse con la interfaz de usuario de forma predeterminada
Cambios no importantes
- Se ha modificado el código de inicialización para alinearse con la interfaz de usuario (tiempo de instalación estimado = 0, requisito de inicio de sesión=solo cuando un usuario ha iniciado sesión).
Approve-CMApprovalRequest
Cambios no importantes
- Se ha agregado el nuevo parámetro InstallActionBehavior (tiene dos opciones: InstallNow, InstallNonBusinessHours), el administrador puede especificar si se debe instalar la aplicación inmediatamente después de que se apruebe o se instale durante horas no laborables. Es un parámetro opcional y, de forma predeterminada, es igual a "InstallNow".
Get-CMDevice
Errores corregidos
- Get-CMDevice falta la propiedad SMSAssignedSites: estaba disponible antes de la versión 1806.
Cambios no importantes
Se han agregado dos nuevos parámetros de conmutador para permitir que el cliente especifique la clase de la salida:
- -ReturnCollectionMember: forzará la instancia de devolución de la clase miembro de la colección sms.
- -ReturnResource: forzará la instancia de devolución de SMS_Resource clase.
Si usa el parámetro predeterminado sin ReturnCollectionMember/ReturnResource, el comportamiento sería el mismo que 1802/1810: la instancia devuelta podría estar en clases diferentes con parámetros especificados diferentes.
Get-CMPackage
Errores corregidos
- Get-CMPackage necesita un modificador -Fast
Cambios no importantes
- Se ha agregado el parámetro -Fast para admitir consultas rápidas.
Import-CMDriver
Errores corregidos
- Set-CMDriver -SupportedPlatformName producirá un error en las matrices
Cambios no importantes
- Se ha corregido el problema de valor de matriz para el parámetro SupportPlatformName.
Invoke-CMScript
Errores corregidos
- Invoke-CMScript cmdlet espera un objeto que no se puede obtener.
Cambios no importantes
- Se corrigió la validación de tipos.
New-CMActiveDirectoryForest
Errores corregidos
- Creación de un bosque de Active Directory: el usuario no funciona a través de PowerShell, solo si se crea a través de la GUI.
Cambios no importantes
- Importó la cuenta a la cuenta global después de que el usuario haya establecido la credencial.
- Se ha agregado el nuevo parámetro -Password para crear credenciales con contraseña.
New-CMApplication
Errores corregidos
- El usuario no puede especificar un parámetro Owner o SupportContact en blanco con el cmdlet New-CMApplication
Cambios no importantes
- Permitir $null para Owner/SupportContact al crear una nueva aplicación, el valor predeterminado sería el usuario actual.
- Se han agregado nuevos parámetros para Owner/SupportContact para admitir la entrada de matriz.
New-CMApplicationDeployment
Cambios no importantes
- Se ha agregado el nuevo parámetro ReplaceToastNotificationWithDialog (booleano), el administrador puede especificar si se deben reemplazar las notificaciones del sistema por el cuadro de diálogo cuando el software necesario esté disponible en el equipo cliente. Es un parámetro opcional y false de forma predeterminada.
New-CMCoManagementPolicy
Cambios no importantes
- Se ha agregado compatibilidad con nuevas cargas de trabajo (DCWorkloadEnabled, O365WorkloadEnabled, ClientAppsWorkloadEnabled).
New-CMDetectionClauseWindowsInstaller
Errores corregidos
- Error de Add/Set-CMMsiDeploymentType -AddDetectionClause "Expresión no válida: el tipo de datos del operando no coincide o el operador no es válido para el tipo de datos".
Cambios no importantes
- Se ha modificado la lógica de la inicialización del tipo de datos para asegurarse de que es correcta cuando se especifica el modificador Existencia.
New-CMOperatingSystemImageUpdateSchedule
Cambios no importantes
- Se ha agregado un nuevo parámetro para que coincida con los cambios realizados para crear el Asistente para programación en la interfaz de usuario:
- -RemoveSupersededUpdates
New-CMOperatingSystemUpgradeUpdateSchedule
Cambios no importantes
- Se ha agregado un nuevo parámetro para que coincida con los cambios realizados para crear el Asistente para programación en la interfaz de usuario:
- -RemoveSupersededUpdates
New-CMPackageDeployment
Errores corregidos
- New-CMPackageDeployment tiene advertencias incoherentes
Cambios no importantes
- Se ha modificado el comportamiento predeterminado de la opción SlowNetwork para alinearse con la interfaz de usuario.
New-CMStatusFilterRule
Errores corregidos
- New-CMStatusFilterRule no funciona según lo esperado
- No se puede crear una nueva regla de filtro de estado con la propiedad "Id. de paquete.
Cambios no importantes
- Se ha agregado más condición para la comprobación de id. de propiedad o valor para desbloquear mayúsculas y minúsculas sin especificar -PropertyID.
- Se ha agregado lógica para permitir el id. de propiedad del conjunto de usuarios = "Id. de paquete" cuando el origen es "Client".
New-CMTaskSequenceDeployment
Errores corregidos
- No se puede establecer la hora de expiración de una implementación de secuencia de tareas
- New-CMTaskSequenceDeployment , $result no puede obtener el objeto de este cmdlet.
Cambios no importantes
- Se ha agregado el alias "DeploymentExpireDateTime" al parámetro -DeadlineDateTime para alinearse con el cmdlet Set-.
- Se ha quitado el bloque using y no se debe eliminar el objeto de implementación.
New-CMTaskSequenceMedia
Cambios no importantes
- Se ha agregado un nuevo parámetro para que coincida con los cambios agregados a la interfaz de usuario de creación de medios de secuencia de tareas:
- -TemporaryFolder (alias "TemporaryDirectory", "StagingArea")
New-CMTSStepRunPowerShellScript
Cambios importantes
- Conjuntos de parámetros agregados: RunScriptFromSource, RunScriptFromPackage.
- Los parámetros PackageID y PackageName ya no son obligatorios porque los usuarios también pueden escribir el nuevo parámetro SourceScript.
Cambios no importantes
- Nuevos parámetros agregados para que coincidan con los cambios realizados en el paso Ejecutar script de Power Shell en la interfaz de usuario del editor de secuencia de tareas:
- -Código fuente
- -WorkingDirectory
- -OutputVariableName
- -Timeout
- -Nombre de usuario
- -Contraseña
- -SuccessCodes
Remove-CMDeviceAffinityFromUser
Errores corregidos
- Add/Remove-CMDeviceAffinityToUser -UserId/-UserName necesita usar "-DeviceId/-DeviceName" juntos.
Cambios no importantes
- Se agregó la comprobación de parámetros para -DeviceID y -DeviceName, el usuario debe especificar al menos uno de ellos.
Set-CMActiveDirectoryForest
Errores corregidos
- Creación de un bosque de Active Directory: el usuario no funciona a través de PowerShell, solo si se crea a través de la GUI.
Cambios no importantes
- Importó la cuenta a la cuenta global después de que el usuario haya establecido la credencial.
- Se ha agregado el nuevo parámetro -Password para crear credenciales con contraseña.
Set-CMApplicationDeployment
Cambios no importantes
- Se ha agregado el nuevo parámetro ReplaceToastNotificationWithDialog (booleano), el administrador puede especificar si se deben reemplazar las notificaciones del sistema por el cuadro de diálogo cuando el software necesario esté disponible en el equipo cliente. Es un parámetro opcional y false de forma predeterminada.
Set-CMClientSetting
Cambios no importantes
- Se ha agregado el nuevo parámetro ReplaceToastNotificationWithDialog (booleano), el administrador puede especificar si se deben reemplazar las notificaciones del sistema por el cuadro de diálogo cuando la máquina requiere reiniciar. Es un parámetro opcional y false de forma predeterminada.
Set-CMClientSettingComputerRestart
Cambios no importantes
- Se ha agregado el nuevo parámetro ReplaceToastNotificationWithDialog (booleano), el administrador puede especificar si se deben reemplazar las notificaciones del sistema por el cuadro de diálogo cuando la máquina requiere reiniciar. Es un parámetro opcional y false de forma predeterminada.
Set-CMComplianceRuleExistential
Errores corregidos
- Set-CMComplianceRuleExistential -Rule no funciona para establecer el valor de regla.
- Set-CMComplianceRuleExistential -ExpectedValue no permite establecer en número negativo, sin el parámetro select [-Existence Occurs] que se ha establecido correctamente.
Cambios no importantes
- Se ha modificado la función WarnIgnoredParameter para asegurarse de que llamaría a IsBoundParameterUsed con el parámetro silent='true' para evitar el error de bloqueo cuando el cmdlet secundario invalida el parámetro base como parámetro no público.
- Se ha movido la validación del resultado esperado a un lugar común.
Set-CMDiscoveryMethod
Errores corregidos
- Set-CMDiscoveryMethod no tiene un parámetro para configurar la cuenta de detección.
Cambios no importantes
- Se ha agregado el nuevo parámetro -UserName para especificar la cuenta de detección para la nueva adición de ADContainer para la detección de usuarios o sistemas de AD.
Set-CMDistributionPoint
Cambios no importantes
- Se ha agregado el parámetro "-EnableLedbat" para habilitar o deshabilitar LEDBAT en DP.
Set-CMDriver
Errores corregidos
- Set-CMDriver -SupportedPlatformName producirá un error en las matrices
Cambios no importantes
- Se ha corregido el problema de valor de matriz para el parámetro SupportPlatformName.
- Se han agregado nuevos parámetros para SupportedPlatform: -AddSupportedPlatformName; -RemoveSupportedPlatformName; -ClearSupportedPlatform
Avisos de desuso
- Parámetro en desuso: -SupportedPlatformName
Set-CMManagementPoint
Cambios importantes
- Se ha modificado la validación de parámetros para alinearse con la interfaz de usuario y se ha agregado código para restablecer el tipo de conexión de cliente cuando se habilita o deshabilita la puerta de enlace en la nube. Se trata de un cambio importante, ya que bloquearía al usuario para habilitar cloud gateway (-EnableCloudGateway) sin SSL.
Errores corregidos
- Set-CMManagementPoint -EnableCloudGateway, en primer lugar establezca MP como HTTPS/EnableCloudGateway true y, a continuación, establezca MP en HTTP, no se debe comprobar EnableCloudGateway.
Set-CMStatusFilterRule
Errores corregidos
- Set-CMStatusFilterRule no funciona con la configuración del identificador de paquete
Cambios no importantes
- Permitir al usuario establecer la propiedad sin especificar el origen de nuevo, lo diferente con la interfaz de usuario es que necesitamos que el usuario especifique -PropertyID y -PropertyValue juntos.
- Se ha agregado código para evitar mensajes de advertencia vacíos cuando el objeto no existe.
Set-CMTSStepRunPowerShellScript
Cambios no importantes
- Nuevos parámetros agregados para que coincidan con los cambios realizados en el paso Ejecutar script de Power Shell en la interfaz de usuario del editor de secuencia de tareas:
- -Código fuente
- -WorkingDirectory
- -OutputVariableName
- -Timeout
- -Nombre de usuario
- -Contraseña
- -SuccessCodes
Set-CMWindowsFirewallPolicy
Errores corregidos
- Set/Remove-CMWindowsFirewallPolicy -InputObject necesita introducir el tipo correcto de New-CMWindowsFirewallPolicy.
Cambios no importantes
- Se corrigió la validación de tipos.