Compartir a través de

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

  • Artículo

Nota

La versión 1604 de la biblioteca de cmdlets de Configuration Manager es la línea base de estos cambios.

Cambios importantes

La consola de administrador permite iniciar el entorno de scripting integrado (ISE)

Desde la consola de administrador, se agregó una opción adicional para iniciar el ISE: "Conectar a través de Windows PowerShell ISE".

Comprobación de actualización de cmdlets

La biblioteca de cmdlets ya no comprobará si hay versiones actualizadas. Esta comprobación ya no es necesaria, ya que la biblioteca de cmdlets ahora se envía simultáneamente con Configuration Manager versiones.

Los cmdlets Get-CM* pueden admitir el modo "Rápido" y pueden devolver una advertencia si no se usa

Algunos cmdlets Get ahora tienen un parámetro Fast . Este parámetro permite al cmdlet devolver objetos sin actualizar automáticamente las propiedades diferidas. La recuperación de valores de propiedad diferida puede provocar tráfico de red adicional y ralentizar la ejecución del cmdlet. Si no se usan propiedades diferidas, se debe proporcionar Fast como parámetro de cmdlet.

Para proporcionar visibilidad sobre este cambio, los cmdlets que admiten Fast escribirán una advertencia en la consola si no se usa en un caso en el que su presencia puede ser beneficiosa. Esta advertencia se puede suprimir estableciendo $CMPSSuppressFastNotUsedCheck = $True.

Cómo proporcionar comentarios o notificar problemas

Muchas de las correcciones y mejoras descritas en este documento son el resultado de los comentarios de los clientes. Para obtener más información, consulte Comentarios del producto.

Problemas conocidos

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

No se puede importar el módulo ConfigurationManager.psd1 mediante el nombre lógico

Si la ruta de acceso al módulo ConfigurationManager.psd1 se agrega a la variable de entorno PSMODULEPATH, no se puede importar mediante Import-Module ConfigurationManager.

Solución alternativa

Add-CMEnrollmentProxyPoint

Es posible que el cmdlet no configure correctamente el punto de proxy de inscripción si hay varios puntos de inscripción para el sitio primario o si el punto de inscripción está en un servidor independiente.

Solución alternativa

  • Use la consola de administrador para esta configuración.

Get-CMAadConditionalAccessPolicy/Set-CMAadConditionalAccessPolicy

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

Solución alternativa

  • Ninguno

Cmdlets nuevos

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

Configuración deL cliente

Se han escrito nuevos cmdlets para mejorar la experiencia en torno a la modificación de la configuración del cliente. Estos cmdlets reemplazan al cmdlet Set-CMClientSetting , que ahora está en desuso. Estos cmdlets admiten el uso de la canalización de objetos desde el cmdlet Get-CMClientSetting para modificar la configuración de cliente definida por el usuario.

  • Set-CMClientSettingBackgroundIntelligentTransfer
  • Set-CMClientSettingClientCache
  • Set-CMClientSettingClientPolicy
  • Set-CMClientSettingCloudService
  • Set-CMClientSettingComplianceSetting
  • Set-CMClientSettingComputerAgent
  • Set-CMClientSettingComputerRestart
  • Set-CMClientSettingEndpointProtection
  • Set-CMClientSettingEnrollment
  • Set-CMClientSettingGeneral
  • Set-CMClientSettingHardwareInventory
  • Set-CMClientSettingMeteredInternetConnection
  • Set-CMClientSettingPowerManagement
  • Set-CMClientSettingRemoteTool
  • Set-CMClientSettingSoftwareDeployment
  • Set-CMClientSettingSoftwareInventory
  • Set-CMClientSettingSoftwareMetering
  • Set-CMClientSettingSoftwareUpdate
  • Set-CMClientSettingStateMessaging
  • Set-CMClientSettingUserAndDeviceAffinity

Directiva de acceso condicional

Se han escrito nuevos cmdlets para admitir la configuración de la directiva de acceso condicional de Azure Active Directory (Azure AD).

  • Get-CMAadConditionalAccessPolicy
  • Set-CMAadConditionalAccessPolicy

Ejemplo

PR1:\> Get-CMAadConditionalAccessPolicy -AccountId 752c1e46-ddd2-4ffc-8f15-23623328c823 -ServicePrincipalType ExchangeOnline -UserCredential (Get-Credential)

PR1:\> Set-CMAadConditionalAccessPolicy -AccountId 752c1e46-ddd2-4ffc-8f15-23623328c823 -ServicePrincipalType ExchangeOnline -Enabled $true -TargetedDevicePlatforms Windows,WindowsPhone -WindowsDeviceState Compliant -IncludedSecurityGroup All_Users -UserCredential (Get-Credential)

Copy-CMCollection

Este cmdlet se puede usar para clonar una colección existente en una nueva.

Endpoint Protection

Nuevos cmdlets para la administración avanzada de directivas de protección contra amenazas:

  • Get-CMAdvancedThreatProtectionPolicy
  • New-CMAdvancedThreatProtectionPolicy
  • Remove-CMAdvancedThreatProtectionPolicy
  • Set-CMAdvancedThreatProtectionPolicy

Get/Set-CMSiteSummaryTask

Estos cmdlets se pueden usar para obtener y establecer tareas de resumen de sitio.

Invoke-CMPromotePreProductionClient

Este cmdlet se puede usar para promover el cliente de preproducción al estado de producción.

Ejemplo

PR1:\> Invoke-CMPromotePreProductionClient -Force

Migración

Nuevos cmdlets para trabajos de migración:

  • Get-CMMigrationJob
  • Set-CMMigrationJob

Rename-CMCategory

Este cmdlet se puede usar para cambiar el nombre de una categoría.

Ejemplo

PR1:\> Get-CMCategory -Name MyCategoryName | Rename-CMCategory -NewName MyCategoryNewName -CategoryType AppCategories

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.

Cambios varios

Errores corregidos

Es posible que los cmdlets de tipo de implementación que requieren un parámetro Url no validen el valor del parámetro para que sea correcto (por ejemplo, Add-CMGooglePlayDeploymentType, Set-CMWindowsPhoneStoreDeploymentType).

Es posible que los cmdlets de tipo de implementación que admiten Mobile Application Management (MAM) no agreguen estos detalles al modelo de aplicación, lo que hace que falte la pestaña "Directivas de App Configuration" de la consola de administrador.

La tecnología add-CM<>los cmdlets DeploymentType no crean tipos de implementación con la misma convención de nomenclatura que la consola de administrador.

Los cmdlets de tipo de implementación que requieren un archivo en lugar de una ruta de acceso de archivo (por ejemplo, Add-CMMsiDeploymentType) ahora notificarán una causa de error más clara si se especifica un argumento inesperado para el parámetro ContentLocation .

Cambios no importantes

Los datos del proveedor que representan __GENERIC objetos WMI ahora muestran más datos en la consola de Windows PowerShell.

"Conectar a través de Windows PowerShell ISE" desde la consola de administrador

Errores corregidos

El script generado no se ejecutó debido a una ruta de acceso no válida al módulo ConfigurationManager. Si ya se ha generado un script no válido, quite el archivo %TEMP%\ISEConnect_sitecode - sitename.ps1 existente y vuelva a iniciar el ISE desde la consola de administrador.

El script generado puede ser ilegible cuando se instala un paquete de idioma de consola de administrador. Si ya se ha generado un script no válido, quite el archivo %TEMP%\ISEConnect_sitecode - sitename.ps1 existente y vuelva a iniciar ISE desde la consola de administrador.

Se puede generar un error de ruta de acceso no válido al iniciar el ISE desde la consola de administrador.

Add-CMDeploymentType

Errores corregidos

El cmdlet puede devolver una advertencia de "Versión inesperada del sitio".

Add-CMDeviceCollectionQueryMembershipRule

Errores corregidos

El cmdlet no comprueba la validez de la consulta especificada por el parámetro QueryExpression . No se pueden crear reglas de consulta con nombres duplicados (no se alinea con el comportamiento de la consola de administrador).

Add-CMDriverToDriverPackage

Errores corregidos

El cmdlet puede eliminar el objeto canalizando.

Add-CMEndpointProtectionPoint

Errores corregidos

Agregar un punto de protección de puntos de conexión por primera vez a un sitio puede dar lugar a una configuración de configuración de cliente predeterminada incorrecta.

Add-CMIntuneSubscription

Errores corregidos

El parámetro ContactEmail no realiza la validación de la corrección.

Add-CMMsiDeploymentType

Errores corregidos

Se omite el valor del parámetro EnableBranchCache .

Cambios no importantes

Se agregó el parámetro InstallationBehaviorType .

Add-CMScriptDeploymentType

Errores corregidos

Se omite el valor del parámetro EnableBranchCache .

Cambios no importantes

Se agregó el parámetro InstallationBehaviorType .

Add-CMUserCollectionQueryMembershipRule

Errores corregidos

El cmdlet no comprueba la validez de la consulta especificada por el parámetro QueryExpression .

No se pueden crear reglas de consulta con nombres duplicados (no se alinea con el comportamiento de la consola de administrador).

Block-CMDevice

Cambios no importantes

El cmdlet ahora acepta el objeto canalizativo de Get-CMDevice.

Export-CMUserCollection

Cambios importantes

Ahora, el cmdlet requiere que el argumento ExportFilePath finalice en una extensión de archivo .mof.

Get-CMCategory

Cambios no importantes

Validación mejorada del parámetro CategoryType .

Get-CMClientSetting

Errores corregidos

Se puede omitir el parámetro SettingType.

Get-CMDeploymentTypeDependency

Errores corregidos

El cmdlet puede devolver dependencias inesperadas.

Get-CMDeviceAction

Errores corregidos

No se puede ver el nuevo código de acceso de una acción PinReset.

Get-CMResource

Errores corregidos

Falta el parámetro fast.

Get-CMSiteRole

Cambios importantes

Cuando se conecta a un sitio primario y no se especifica ningún parámetro SiteCode , solo se devolverán los roles específicos del sitio conectado. Este cambio se realizó para tener paridad y coherencia con la consola de administrador. Por ejemplo, si tiene un CAS y ejecuta el cmdlet en un sitio primario, solo se usarán los roles de sitio para el código de sitio actual. Los roles de sitio para todos los sitios se devolverán al ejecutarse desde un CAS.

Para restaurar el comportamiento anterior, el parámetro AllSites se puede usar para consultar todos los sitios de la jerarquía desde cualquier sitio conectado.

Get-CMSoftwareUpdate

Errores corregidos

El cmdlet puede eliminar el valor del parámetro UpdateGroup.

Import-CMAntimalwarePolicy

Errores corregidos

Las directivas exportadas desde versiones anteriores de Configuration Manager pueden no importarse correctamente.

Import-CMAntimalwarePolicy

Errores corregidos

Es posible que la directiva no se importe o que se cree con errores de validación.

El cmdlet permite importar un archivo que ya se ha importado.

Import-CMComputerInformation

Cambios importantes

El parámetro CollectionName ahora es obligatorio.

Cambios no importantes

Se ha agregado compatibilidad para importar equipos por su nombre de dominio completo.

Import-CMDriver

Cambios importantes

Si se produce una importación parcial de controladores, el cmdlet ya no producirá un error. En su lugar, advertirá de que algunos controladores no se importaron correctamente. En un evento en el que no se puede importar ningún controlador, el cmdlet seguirá produciendo un error.

Import-CMDriverPackage

Cambios no importantes

Nuevo parámetro ImportActionType para controlar el comportamiento cuando ya existe un paquete.

Import-CMPackage

Cambios no importantes

Nuevo parámetro ImportActionType para controlar el comportamiento cuando ya existe un paquete.

Import-CMSecurityRole

Errores corregidos

El cmdlet permite usar valores de parámetro NewRoleName no válidos.

Import-CMTaskSequence

Cambios no importantes

Nuevo parámetro ImportActionType para controlar el comportamiento cuando ya existe un paquete.

Invoke-CMDeviceAction

Errores corregidos

El cmdlet puede producir un error con una excepción si cierta información de detección no está disponible para el dispositivo de destino.

Invoke-CMDeviceRetire

Errores corregidos

Se produce un error en el cmdlet de forma silenciosa cuando el usuario no tiene permiso para invocar la operación de retirada.

El cmdlet no produce un error con un mensaje de error claro al intentar retirar un dispositivo no compatible.

El cmdlet no produce un error con un mensaje de error claro al intentar retirar un dispositivo borrado.

Cambios no importantes

Nuevo parámetro Cancel para cancelar una retirada de dispositivo pendiente.

Invoke-CMDeviceWipe

Errores corregidos

Se produce un error en el cmdlet de forma silenciosa cuando el usuario no tiene permiso para invocar la operación de borrado.

El cmdlet no produce un error con un mensaje de error claro al intentar borrar un dispositivo no compatible.

Es posible que no pueda borrar Intune dispositivo administrado.

Cambios no importantes

Nuevo parámetro Cancel para cancelar un borrado de dispositivo pendiente.

Invoke-CMSoftwareUpdateAutoDeploymentRule

Errores corregidos

El cmdlet puede eliminar el objeto canalizando.

Move-CMObject

Errores corregidos

El cmdlet no encuentra un objeto que se va a mover.

New-CMBootableMedia

Errores corregidos

El cmdlet no valida correctamente los valores de los parámetros CertificateExpireTime y CertificateStartTime .

New-CMCaptureMedia

Cambios importantes

Se han quitado los parámetros PrestartCommand y PrestartPackage innecesarios.

New-CMCategory

Errores corregidos

El cmdlet permite la creación de un tipo de categoría GlobalCondition no compatible.

Cambios no importantes

Validación mejorada del parámetro CategoryType .

New-CMClientSetting

Cambios importantes

El parámetro SettingType ahora es obligatorio.

New-CMComputerAssociation

Cambios no importantes

Mejoras en el rendimiento.

New-CMDeviceVariable

Errores corregidos

No se pueden crear variables de dispositivo para un miembro del sitio primario desde cas.

El cmdlet puede eliminar el objeto de colección canalizada.

New-CMGlobalCondition

Errores corregidos

No se valida la longitud del valor del parámetro InstanceName.

Cambios no importantes

Se ha agregado la capacidad de crear tipos de datos de configuración base64 y xml.

New-CMPowerManagementCustomPlan

Errores corregidos

Los parámetros DisplayOffMinAC y DisplayOffMinDC no están configurados en el plan resultante.

New-CMPrestageMedia

Cambios no importantes

Se agregaron los parámetros MediaPassword, TaskSequence e IncludeApplicationDependency .

New-CMQuery

Errores corregidos

El cmdlet no valida si el nombre de la consulta ya existe.

New-CMTaskSequence

Errores corregidos

La reversión no está configurada cuando se usa el parámetro UpgradeOperatingSystem .

Novedades y los pasos de la aplicación no se colocan en las posiciones esperadas cuando se usa el parámetro UpgradeOperatingSystem.

New-CMWindowsEnrollmentProfile

Errores corregidos

Es posible que el perfil de inscripción no contenga una configuración de intranet válida.

Remove-CMAdministrativeUser

Cambios importantes

Se quitó el parámetro RoleName no funcional.

Remove-CMContentDistribution

Errores corregidos

El cmdlet puede eliminar el objeto canalizando.

Remove-CMDeviceVariable

Errores corregidos

El cmdlet producirá un error silencioso si intenta quitar una variable que no existe.

No se pueden quitar las variables de dispositivo de un miembro del sitio primario del CAS.

El cmdlet puede rechazar un objeto de miembro de colección canalizada válido.

Remove-CMIntuneSubscription

Errores corregidos

El cmdlet puede producir un error de forma silenciosa o con un mensaje de error no claro si no existe una suscripción Microsoft Intune.

Remove-CMMaintenanceWindow

Errores corregidos

El cmdlet puede omitir el parámetro Name y quitar ventanas de mantenimiento adicionales.

Cambios no importantes

El cmdlet admite la sugerencia de parámetro DisableWildcardHandling para el parámetro Name .

Remove-CMMulticastServicePoint

Errores corregidos

La especificación del parámetro RemoveWDS con un valor de false puede hacer que se quite la característica WDS.

Set-CMAppVVirtualEnvironment

Errores corregidos

El parámetro AddApplicationGroup no comprueba si el grupo ya se ha agregado.

Set-CMBaselineDeployment

Errores corregidos

El cmdlet puede omitir de forma silenciosa OverrideServiceWindow si la aplicación no está habilitada para la implementación.

Set-CMBoundaryGroup

Errores corregidos

El parámetro DefaultSiteCode no permite el valor NULL para borrar la configuración.

Set-CMClientSetting

Avisos de desuso

El cmdlet ha quedado en desuso y se ha reemplazado por un cmdlet específico de la característica. Consulte Nuevos cmdlets para obtener más detalles.

Set-CMCollectionMembershipEvaluationComponent

Avisos de desuso

El parámetro SiteSystemServerName ha quedado en desuso.

Set-CMCollectionPowerManagement

Errores corregidos

No se puede cambiar una directiva de administración de energía de NeverApply a Aplicar.

Set-CMConditionalAccessPolicy

Errores corregidos

Es posible que el cmdlet no modifique las colecciones excluidas al especificar una directiva mediante los parámetros Name o Id .

Set-CMDeploymentType

Errores corregidos

El cmdlet puede devolver una advertencia de "Versión inesperada del sitio".

Set-CMDeviceVariable

Errores corregidos

El cmdlet producirá un error silencioso si se intenta establecer una variable que no existe.

No se pueden configurar variables de dispositivo para un miembro del sitio primario desde cas.

El cmdlet puede rechazar un objeto de miembro de colección canalizada válido.

Cambios no importantes

Nuevo parámetro PassThru para devolver la variable de dispositivo resultante.

Set-CMDistributionPoint

Errores corregidos

El cmdlet puede devolver advertencias inesperadas sobre la configuración del punto de servicio de multidifusión.

Set-CMFileReplicationRoute

Errores corregidos

No se puede establecer FileReplicationAccountName sin especificar un modo de replicación.

Set-CMGlobalCondition

Errores corregidos

No se valida la longitud del valor del parámetro InstanceName.

Set-CMIntuneSubscription

Errores corregidos

El parámetro ContactEmail no realiza la validación de la corrección.

Set-CMIntuneSubscriptionAppleMdmProperty

Errores corregidos

Es posible que el cmdlet no advierta cuando no se cumplan ciertas dependencias de parámetros necesarias.

Set-CMIntuneSubscriptionPassportForWorkProperty

Errores corregidos

Se puede omitir el valor del parámetro EnableBiometrics.

Set-CMIntuneSubscriptionWindowsPhoneProperty

Errores corregidos

Es posible que no se produzca un error en el cmdlet cuando se usen determinadas combinaciones de parámetros no válidas.

Set-CMMigrationJob

Errores corregidos

Especificar el parámetro UtcTime sin el parámetro MigrationJobSchedule puede dar lugar a una configuración de trabajo de migración no válida.

Set-CMMigrationSource

Errores corregidos

El cmdlet producirá un error silencioso si intenta crear un origen de migración con un nombre que ya existe.

Cambios no importantes

El cmdlet intentará expandir el valor del parámetro SourceSiteServerName si no se usa un nombre de dominio completo.

Set-CMMsiDeploymentType

Cambios no importantes

Se agregó el parámetro InstallationBehaviorType .

Set-CMScriptDeploymentType

Cambios no importantes

Se agregó el parámetro InstallationBehaviorType .

Set-CMSite

Errores corregidos

El cmdlet puede producir un error si se usa el parámetro SiteCode .

Cambios no importantes

Se quitaron los conjuntos de parámetros adicionales sin usar (SetSecurityScopeByName, SetSecurityScopeBySiteCode y SetSecurityScopeByValue).

Set-CMSiteMaintenanceTask

Cambios importantes

Se ha quitado el parámetro SiteCode.

Avisos de desuso

El parámetro SummaryTask ha quedado en desuso. TaskName debe usarse en su lugar.

Cambios no importantes

Acepta la entrada canalizadas de Get-CMSiteMaintenanceTask.

Varias mejoras de facilidad de uso.

Se agregó el parámetro TaskName para establecer una tarea por su nombre.

Set-CMSoftwareUpdateDeployment

Cambios no importantes

Se ha mejorado la salida al usar Confirm o WhatIf.

Set-CMSoftwareUpdatePointComponent

Errores corregidos

No se puede especificar "Publicador local" como un valor para el parámetro AddCompany .

Set-CMSoftwareUpdateSummarizationSchedule

Cambios no importantes

Se ha mejorado la salida al usar Confirm o WhatIf.

Start-CMBaselineDeployment

Errores corregidos

El cmdlet puede omitir de forma silenciosa OverrideServiceWindow si la aplicación no está habilitada para la implementación.

Start-CMContentDistribution

Errores corregidos

El cmdlet puede eliminar el objeto canalizando.

Start-CMTaskSequenceDeployment

Errores corregidos

Es posible que la implementación no se cree correctamente si no se especifica el parámetro DeploymentOption .

El cmdlet puede devolver una advertencia de que los parámetros PercentSuccess o PercentFailure se omiten cuando no se especifican.

Cambios no importantes

Si no se especifica DeploymentOption , se implica un valor de DownloadContentLocallyWhenNeededByRunningTaskSequence.

Unblock-CMDevice

Cambios no importantes

El cmdlet ahora acepta el objeto canalizativo de Get-CMDevice.

Unlock-CMObject

Cambios no importantes

Ahora se producirá un error en el cmdlet si se intenta desbloquear un objeto bloqueado por otra sesión del proveedor de SMS. En versiones anteriores, esto produciría un error silencioso.

Se ha agregado el parámetro Force para intentar desbloquear objetos que pueden estar bloqueados por otra sesión del proveedor de SMS. Esto se puede usar para recuperarse de un escenario en el que un objeto se bloqueó mediante una consola de administrador que se quitó inesperadamente sin liberar el bloqueo del objeto.