Gerenciador de Configurações da biblioteca de cmdlets da versão 2107
Aplica-se a: Configuration Manager (branch atual)
Essas notas de versão resumem as alterações na biblioteca Gerenciador de Configurações cmdlets na versão 2107.
Observação
Gerenciador de Configurações branch atual versão 2103 é a linha de base para essas alterações. Para obter mais informações, consulte Gerenciador de Configurações de biblioteca de cmdlets para a versão 2103.
Novos cmdlets para tipos de implantação de aplicativo
Gerenciar comportamentos de instalação para tipos de implantação de aplicativo
Esse conjunto de novos cmdlets é para o comportamento de instalação do tipo de implantação de aplicativo. Para obter mais informações gerais sobre o recurso de comportamento de instalação, confira Verificar se há arquivos em execução.
Add-CMDeploymentTypeInstallBehavior
Use este cmdlet para adicionar ao tipo de implantação especificado os arquivos executáveis que precisam ser fechados para que a instalação do aplicativo seja realizada com sucesso.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -DisplayName "Notepad"
Para obter mais informações, consulte Add-CMDeploymentTypeInstallBehavior.
Get-CMDeploymentTypeInstallBehavior
Use este cmdlet para obter do tipo de implantação especificado a lista de arquivos executáveis que precisam ser fechados para que a instalação do aplicativo seja realizada com sucesso.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Get-CMDeploymentTypeInstallBehavior -InputObject $msi_dt
Para obter mais informações, consulte Get-CMDeploymentTypeInstallBehavior.
Remove-CMDeploymentTypeInstallBehavior
Use este cmdlet para adicionar ao tipo de implantação especificado os arquivos executáveis que precisam ser fechados para que a instalação do aplicativo seja realizada com sucesso.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe"
Para obter mais informações, consulte Remove-CMDeploymentTypeInstallBehavior.
Set-CMDeploymentTypeInstallBehavior
Use esse cmdlet para modificar os arquivos executáveis que precisam ser fechados para que a instalação do aplicativo seja realizada com sucesso.
$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 obter mais informações, consulte Set-CMDeploymentTypeInstallBehavior.
Gerenciar códigos de retorno para tipos de implantação de aplicativos
Esse conjunto de novos cmdlets é para códigos de retorno do tipo de implantação de aplicativo. Para obter mais informações gerais, confira Códigos de retorno do tipo de implantação.
Add-CMDeploymentTypeReturnCode
Use esse cmdlet para adicionar códigos de retorno a um tipo de implantação com suporte.
$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 obter mais informações, consulte Add-CMDeploymentTypeReturnCode.
Get-CMDeploymentTypeReturnCode
Use esse cmdlet para obter a lista de códigos de retorno do tipo de implantação especificado.
Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)" | Get-CMDeploymentTypeReturnCode
Para obter mais informações, consulte Get-CMDeploymentTypeReturnCode.
Remove-CMDeploymentTypeReturnCode
Use esse cmdlet para excluir códigos de retorno do tipo de implantação especificado.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602
Para obter mais informações, consulte Remove-CMDeploymentTypeReturnCode.
Set-CMDeploymentTypeReturnCode
Use esse cmdlet para modificar códigos de retorno para o tipo de implantação 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 obter mais informações, consulte Set-CMDeploymentTypeReturnCode.
Outros cmdlets novos
Get-CMClientSettingDeployment
Use esse cmdlet para obter uma implantação de um objeto de configuração de cliente personalizado. Você pode usar esse objeto com Remove-CMClientSettingDeployment.
Para saber mais sobre configurações de cliente, confira Como definir configurações de cliente.
$clientSetting = Get-CMClientSetting -Name "Software Center customizations"
$clientSetting | Get-CMClientSettingDeployment
Para obter mais informações, consulte Get-CMClientSettingDeployment.
Get-CMDeploymentTypeDetectionClause
Use este cmdlet para obter as cláusulas de detecção do tipo de implantação especificado.
Você pode usar esse cmdlet para obter uma cláusula de detecção de um aplicativo e aplicá-lo a outro, por exemplo:
$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 obter mais informações, consulte Get-CMDeploymentTypeDetectionClause.
Get-CMPersistentUserSettingsGroup
Use esse cmdlet para obter a lista de configurações em todo o site que você armazenou. Essas configurações seguem você em dispositivos diferentes.
Por exemplo, as notificações de console do Configuration Manager que estão ativas ou que você descartou.
Para obter mais informações, consulte Get-CMPersistentUserSettingsGroup.
Get-CMSoftwareUpdateContentInfo
Use este cmdlet para obter informações de conteúdo de atualização de software.
$update = Get-CMSoftwareUpdate -ArticleId "5004237" -Fast
Get-CMSoftwareUpdateContentInfo -InputObject $update[1]
Para obter mais informações, consulte Get-CMSoftwareUpdateContentInfo.
Remove-CMPersistentUserSettingsGroup
Use esse cmdlet para redefinir suas configurações em todo o site.
Por exemplo, você pode restaurar as notificações de console do Configuration Manager que você descartou. Depois de executar esse cmdlet e reiniciar o console do Configuration Manager, você verá todas as notificações disponíveis novamente.
Para obter mais informações, consulte Remove-CMPersistentUserSettingsGroup.
Cmdlets preterido e removidos
Os seguintes cmdlets para iniciar uma implantação são preteridos e podem ser removidos em uma versão futura:
| Cmdlet preterido | Substituição |
|---|---|
| Start-CMApplicationDeploymentSimulation | New-CMApplicationDeployment com o parâmetro Simulation |
| Start-CMClientSettingDeployment | New-CMClientSettingDeployment |
| Start-CMAntimalwarePolicyDeployment | New-CMAntimalwarePolicyDeployment |
Os cmdlets abaixo não estão mais disponíveis porque os recursos subjacentes não recebem mais suporte:
Add-CMApplicationCatalogWebServicePoint
Add-CMApplicationCatalogWebsitePoint
Get-CMApplicationCatalogWebServicePoint
Get-CMApplicationCatalogWebsitePoint
Remove-CMApplicationCatalogWebServicePoint
Remove-CMApplicationCatalogWebsitePoint
Set-CMApplicationCatalogWebsitePoint
Get-CMVhd
New-CMVhd
Remove-CMVhd
Set-CMVhd
Alterações de cmdlet
As alterações a seguir foram feitas em cmdlets existentes nesta versão. As alterações podem ser novas funcionalidades ou correções de bugs. Algumas alterações podem estar quebrando. Se você usar um dos cmdlets ou áreas de recursos listadas nesta seção, revise cuidadosamente as alterações para entender como elas podem afetar seu uso.
Add-CMDeviceCollectionDirectMembershipRule
Para mais informações, confira Add-CMDeviceCollectionDirectMembershipRule.
Bugs corrigidos
Correção de um problema ao tentar adicionar milhares de dispositivos como regras de associação direta.
Add-CMDistributionPoint
Para saber mais, confira Add-CMDistributionPoint.
Alterações da falha
O espaço livre mínimo padrão foi alterado de 50 MB para 500 MB.
Add-CMTaskSequenceStep
Para obter mais informações, confira Add-CMTaskSequenceStep.
Alterações sem interrupção
Parâmetro desnecessário StepName removido.
Disconnect-CMTrackedObject
Para obter mais informações, confira Disconnect-CMTrackedObject.
Alterações sem interrupção
Alias Disconnect-CMObject adicionado a esse cmdlet.
Get-CMApplicationGroup
Para obter mais informações, consulte Get-CMApplicationGroup.
Bugs corrigidos
Um problema ao obter o caminho correto do grupo de aplicativos foi consertado.
Get-CMDeploymentStatusDetails
Para obter mais informações, consulte Get-CMDeploymentStatusDetails.
Bugs corrigidos
Correção da condição de consulta para evitar possíveis problemas de incompatibilidade de tipo.
Import-CMAntimalwarePolicy
Para obter mais informações, consulte Import-CMAntimalwarePolicy.
Alterações sem interrupção
Suporte adicionado para a política de modo de auditoria com aplicativos potencialmente indesejados. Para obter mais informações, consulte modo de auditoria para aplicativos potencialmente indesejados.
Import-CMQuery
Para obter mais informações, consulte Import-CMQuery.
Bugs corrigidos
Um problema ao desbloquear a função de importação foi consertado.
New-CMAdministrativeUser
Para obter mais informações, consulte New-CMAdministrativeUser.
Bugs corrigidos
Corrigido um problema quando o nome de usuário é me .
New-CMApplicationDeployment
Para obter mais informações, consulte New-CMApplicationDeployment.
Alterações sem interrupção
Adicionado o parâmetro AutoCloseExecutable para habilitar a configuração de implantação de aplicativo para comportamentos de instalação.
New-CMCloudManagementGateway
Para obter mais informações, confira New-CMCloudManagementGateway.
Alterações da falha
Agora é exigido o parâmetro ServiceCertPassword.
New-CMMigrationJob
Para obter mais informações, consulte New-CMMigrationJob.
Bugs corrigidos
Desbloqueada a migração de objetos de implantação de distribuição de software.
New-CMSecondarySite
Para obter mais informações, consulte New-CMSecondarySite.
Alterações da falha
O espaço livre mínimo padrão foi alterado de 200 MB para 500 MB.
New-CMSoftwareUpdateAutoDeploymentRule
Para obter mais informações, confira New-CMSoftwareUpdateAutoDeploymentRule.
Bugs corrigidos
Corrigido um problema com o parâmetro Product . Quando há vários produtos com o mesmo nome, agora ele seleciona todos eles.
New-CMSoftwareUpdateDeployment
Para obter mais informações, consulte New-CMSoftwareUpdateDeployment.
Alterações sem interrupção
O alias Descrição foi adicionado ao parâmetro Comment.
New-CMTaskSequence
Para obter mais informações, confira New-CMTaskSequence.
Alterações sem interrupção
Extensão do comprimento máximo do parâmetro Description para
512caracteres.Adição do novo parâmetro HighPerformance para dar suporte à configuração de desempenho.
O parâmetro InstallationLicensingMode herdado foi removido.
O conjunto de parâmetros NewInstallOSImageVhd foi removido.
O parâmetro InstallOperatingSystemImageVhd foi removido.
New-CMTaskSequenceDeployment
Para obter mais informações, consulte New-CMTaskSequenceDeployment.
Bugs corrigidos
Correção de um problema com planos de energia de alto desempenho.
New-CMTSStepApplyDriverPackage
Para obter mais informações, consulte New-CMTSStepApplyDriverPackage.
Alterações sem interrupção
Adicionada uma condição para validar um pacote para a PackageID especificada.
New-CMTSStepApplyOperatingSystem
Para obter mais informações, confira New-CMTSStepApplyOperatingSystem.
Bugs corrigidos
Correção de problemas de validação com o parâmetro DestinationVariable para permitir valores que começam com um sublinhado (_).
Alterações sem interrupção
Adicionado o parâmetro layereddriver para dar suporte ao driver de teclado em camadas durante a implantação do sistema operacional.
New-CMTSStepUpgradeOperatingSystem
Para obter mais informações, consulte New-CMTSStepUpgradeOperatingSystem.
Alterações sem interrupção
O novo parâmetro SoftwareUpdate foi adicionado para especificar uma atualização de recurso da etapa da sequência de tarefas Atualizar sistema operacional.
Publish-CMPrestageContent
Para obter mais informações, consulte Publish-CMPrestageContent.
Bugs corrigidos
Correção de problema potencial de objeto inválido.
Remove-CMApplicationGroup
Para obter mais informações, consulte Remove-CMApplicationGroup.
Bugs corrigidos
Um problema ao obter o caminho correto do grupo de aplicativos ao usar o pipeline foi consertado.
Set-CMAntimalwarePolicy
Para obter mais informações, consulte set-CMAntimalwarePolicy.
Alterações sem interrupção
Adicionado o parâmetro PuaProtection para dar suporte a aplicativos potencialmente indesejados.
Set-CMApplicationDeployment
Para obter mais informações, consulte set-CMApplicationDeployment.
Alterações sem interrupção
Adicionado o parâmetro AutoCloseExecutable para habilitar a configuração de implantação de aplicativo para comportamentos de instalação.
Set-CMClientSetting
Para obter mais informações, consulte set-CMClientSetting.
Alterações sem interrupção
Uma mensagem de substituição significativa para o parâmetro SoftwareMetering foi adicionada.
Set-CMClientSettingSoftwareUpdate
Para obter mais informações, consulte set-CMClientSettingSoftwareUpdate.
Alterações sem interrupção
Adicionado o parâmetro EnableWsusCertPinning para dar suporte à fixação do certificado.
Set-CMDeploymentType
Para obter mais informações, confira Set-CMDeploymentType.
Bugs corrigidos
Problema com o parâmetro AddRequirement corrigido para adicionar novas regras.
Set-CMMsiDeploymentType
Para obter mais informações, consulte Set-CMMsiDeploymentType.
Bugs corrigidos
Atualize o tipo de implantação de acordo com o tipo de instalador para evitar redefinir as configurações ao alterar a localização do conteúdo.
Alterações sem interrupção
Adicione suporte para especificar um caminho de pasta para o parâmetro ContentLocation.
Set-CMTaskSequence
Para obter mais informações, consulte Set-CMTaskSequence.
Alterações sem interrupção
Adicionado novo parâmetro HighPerformance para dar suporte à configuração de desempenho para a sequência de tarefas.
Set-CMTSStepApplyDriverPackage
Para obter mais informações, consulte Set-CMTSStepApplyDriverPackage.
Alterações sem interrupção
Adicionada uma condição para validar um pacote para o PackageId especificado.
Set-CMTSStepApplyOperatingSystem
Para obter mais informações, consulte Set-CMTSStepApplyOperatingSystem.
Bugs corrigidos
Corrigido um problema com o parâmetro Destination.
Alterações sem interrupção
Adicionado o parâmetro LayeredDriver para dar suporte ao driver de teclado em camadas durante a implantação do sistema operacional.
Set-CMTSStepUpgradeOperatingSystem
Para obter mais informações, consulte Set-CMTSStepUpgradeOperatingSystem.
Alterações sem interrupção
O novo parâmetro SoftwareUpdate foi adicionado para especificar uma atualização de recurso da etapa da sequência de tarefas Atualizar sistema operacional.
Start-CMDistributionPointUpgrade
Para obter mais informações, consulte Start-CMDistributionPointUpgrade.
Alterações da falha
De definir o espaço livre mínimo padrão como 500 MB.
Update-CMDistributionPoint
Para obter mais informações, confira Update-CMDistributionPoint.
Bugs corrigidos
Corrigido um problema na atualização de conteúdo das pastas install e uninstall quando não são as mesmas.
Como fornecer comentários ou relatar problemas
Muitas das correções e melhorias descritas neste artigo são resultado de seus comentários.
Para enviar comentários, use o Gerenciador de Configurações console. Para obter mais informações, consulte Comentários sobre o PowerShell.
Para enviar novas solicitações de recurso, consulte o grupo do PowerShell de Gerenciador de Configurações no UserVoice.