Alterações na biblioteca cmdlet do Gestor de Configuração para a versão 2107
Aplica-se a: Configuration Manager (ramo atual)
Estas notas de lançamento resumem as alterações à biblioteca cmdlet do Gestor de Configuração na versão 2107.
Nota
A versão atual do bloco de configuração 2103 é a linha de base para estas alterações. Para obter mais informações, consulte as alterações da biblioteca cmdlet do Gestor de Configuração para a versão 2103.
Novos cmdlets para tipos de implementação de aplicações
Gerir comportamentos de instalação para tipos de implementação de aplicações
Este conjunto de novos cmdlets destina-se ao comportamento de instalação do tipo de implementação da aplicação. Para obter informações mais gerais sobre a função de comportamento da instalação, consulte verifique se existem ficheiros executáveisem execução .
Add-CMDeploymentTypeInstallBehavior
Utilize este cmdlet para adicionar ao tipo de implementação especificado os ficheiros executáveis que precisam de fechar para que a instalação da aplicação tenha 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
Utilize este cmdlet para obter do tipo de implementação especificado a lista de ficheiros executáveis que precisam de fechar para que a instalação da aplicação tenha 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
Utilize este cmdlet para remover do tipo de implementação especificado os ficheiros executáveis que precisam de fechar para que a instalação da aplicação tenha 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
Utilize este cmdlet para modificar os ficheiros executáveis que precisam de ser fechados para que a instalação da aplicação tenha 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.
Gerir códigos de devolução para tipos de implementação de aplicações
Este conjunto de novos cmdlets destina-se a códigos de devolução do tipo de implementação da aplicação. Para obter informações mais gerais, consulte códigos de devolução do tipo de implementação.
Add-CMDeploymentTypeReturnCode
Utilize este cmdlet para adicionar códigos de devolução a um tipo de implementação suportado.
$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 mais informações, consulte Add-CMDeploymentTypeReturnCode.
Get-CMDeploymentTypeReturnCode
Utilize este cmdlet para obter a lista de códigos de devolução do tipo de implantação especificado.
Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)" | Get-CMDeploymentTypeReturnCode
Para mais informações, consulte Get-CMDeploymentTypeReturnCode.
Remove-CMDeploymentTypeReturnCode
Utilize este cmdlet para eliminar os códigos de devolução 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
Utilize este cmdlet para modificar os códigos de devolução 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 mais informações, consulte Set-CMDeploymentTypeReturnCode.
Outros novos cmdlets
Get-CMClientSettingDeployment
Utilize este cmdlet para obter uma implantação de um objeto de configuração personalizada do cliente. Pode utilizar este objeto com Remove-CMClientSettingDeployment.
Para obter mais informações sobre as definições do cliente, consulte como configurar as definições do cliente.
$clientSetting = Get-CMClientSetting -Name "Software Center customizations"
$clientSetting | Get-CMClientSettingDeployment
Para obter mais informações, consulte Get-CMClientSettingDeployment.
Get-CMDeploymentTypeDetectionClause
Utilize este cmdlet para obter as cláusulas de deteção do tipo de implementação especificado.
Pode usar este cmdlet para obter uma cláusula de deteção de uma aplicação e aplicá-la a outra, 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
Utilize este cmdlet para obter a lista das definições em todo o site que guardou. Estas definições seguem-no em diferentes dispositivos.
Por exemplo, notificações de consola do Gestor de Configuração que estão ativas ou que tenha rejeitado.
Para obter mais informações, consulte o Get-CMPersistentUserSettingsGroup.
Get-CMSoftwareUpdateContentInfo
Utilize 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 mais informações, consulte Get-CMSoftwareUpdateContentInfo.
Remove-CMPersistentUserSettingsGroup
Utilize este cmdlet para redefinir as definições do site.
Por exemplo, pode restaurar as notificações de consola do Gestor de Configuração que dispensou. Depois de executar este cmdlet e reiniciar a consola Do Gestor de Configuração, verá todas as notificações disponíveis novamente.
Para obter mais informações, consulte Remove-CMPersistentUserSettingsGroup.
Cmdlets preprecados e removidos
Os seguintes cmdlets para iniciar uma implantação são precotados e podem ser removidos numa versão futura:
| Cmdlet preterido | Substituição |
|---|---|
| Start-CMApplicationDeploymentSimulation | Novo CMApplicationDeploimento com o parâmetro de Simulação |
| Start-CMClientSettingDeployment | Novo CMClientSettingDeployment |
| Start-CMAntimalwarePolicyDeployment | Novo CMAntimalwarePolitamento dedeployment |
Os cmdlets seguintes já não estão disponíveis porque as características subjacentes já não são suportadas:
Add-CMApplicationCatalogWebServicePoint
Add-CMApplicationCatalogWebsitePoint
Get-CMApplicationCatalogWebServicePoint
Get-CMApplicationCatalogWebsitePoint
Remove-CMApplicationCatalogWebServicePoint
Remove-CMApplicationCatalogWebsitePoint
Set-CMApplicationCatalogWebsitePoint
Get-CMVhd
New-CMVhd
Remove-CMVhd
Set-CMVhd
Alterações do Cmdlet
Foram feitas as seguintes alterações aos cmdlets existentes nesta versão. As alterações podem ser novas funcionalidades ou correções de bugs. Algumas mudanças podem estar a rebentar. Se utilizar um dos cmdlets ou áreas de funcionalidade listadas nesta secção, reveja cuidadosamente as alterações para entender como podem afetar a sua utilização.
Add-CMDeviceCollectionDirectMembershipRule
Para mais informações, consulte Add-CMDeviceCollectionDirectMembershipRule.
Insetos que foram corrigidos
Corrigiu um problema ao tentar adicionar milhares de dispositivos como regras de adesão direta.
Add-CMDistributionPoint
Para obter mais informações, consulte Add-CMDistributionPoint.
Alterações interruptivas
O espaço livre mínimo padrão passou de 50 MB para 500 MB.
Add-CMTaskSequenceStep
Para obter mais informações, consulte Add-CMTaskSequenceStep.
Alterações não-quebrando
Removido parâmetro desnecessário StepName.
Disconnect-CMTrackedObject
Para obter mais informações, consulte Disconnect-CMTrackedObject.
Alterações não-quebrando
Adicionado pseudónimo Disconnect-CMObject para este cmdlet.
Get-CMApplicationGroup
Para mais informações, consulte o Get-CMApplicationGroup.
Insetos que foram corrigidos
Corrigi um problema para obter o caminho correto do grupo de aplicações.
Get-CMDeploymentStatusDetails
Para obter mais informações, consulte Get-CMDeploymentStatusDetails.
Insetos que foram corrigidos
Condição de consulta fixa para evitar problemas de incompatibilidade do tipo potencial.
Import-CMAntimalwarePolicy
Para mais informações, consulte Import-CMAntimalwarePolicy.
Alterações não-quebrando
Suporte adicionado para a política do modo de auditoria com aplicações potencialmente indesejadas. Para obter mais informações, consulte o modo de auditoria para aplicações potencialmente indesejadas.
Import-CMQuery
Para mais informações, consulte Import-CMQuery.
Insetos que foram corrigidos
Corrigiu um problema para desbloquear a função de importação.
New-CMAdministrativeUser
Para mais informações, consulte a New-CMAdministrativeUser.
Insetos que foram corrigidos
Corrigi um problema quando o nome de utilizador é me .
New-CMApplicationDeployment
Para mais informações, consulte New-CMApplicationDeployment.
Alterações não-quebrando
Adicione o parâmetro AutoCloseExecutable para permitir a definição de implementação da aplicação para comportamentos de instalação.
New-CMCloudManagementGateway
Para mais informações, consulte New-CMCloudManagementGateway.
Alterações interruptivas
O parâmetro ServiceCertPassword é agora necessário.
New-CMMigrationJob
Para mais informações, consulte New-CMMigrationJob.
Insetos que foram corrigidos
Desbloqueou a migração de objetos de distribuição de software.
New-CMSecondarySite
Para mais informações, consulte o New-CMSecondarySite.
Alterações interruptivas
Alterou o espaço livre mínimo padrão de 200 MB para 500 MB.
New-CMSoftwareUpdateAutoDeploymentRule
Para mais informações, consulte New-CMSoftwareUpdateAutoDeploymentRule.
Insetos que foram corrigidos
Corrigiu um problema com o parâmetro do Produto. Quando há vários produtos com o mesmo nome, agora seleciona todos eles.
New-CMSoftwareUpdateDeployment
Para mais informações, consulte New-CMSoftwareUpdateDeployment.
Alterações não-quebrando
Alias de descrição adicionada ao parâmetro de comentário.
New-CMTaskSequence
Para mais informações, consulte New-CMTaskSequence.
Alterações não-quebrando
Estendia o comprimento máximo do parâmetro Descrição aos
512caracteres.Adicionou novo parâmetro HighPerformance para suportar a definição de desempenho.
O parâmetro de InstalaçãoLicensingMode foi removido.
Removido o conjunto de parâmetros NewInstallOSImageVhd.
Removido o parâmetro InstallOperatingSystemImageVhd.
New-CMTaskSequenceDeployment
Para mais informações, consulte New-CMTaskSequenceDeployment.
Insetos que foram corrigidos
Corrigi um problema com planos de alta potência.
New-CMTSStepApplyDriverPackage
Para mais informações, consulte New-CMTSStepApplyDriverPackage.
Alterações não-quebrando
Adicionou uma condição para validar um pacote para o PackageId especificado .
New-CMTSStepApplyOperatingSystem
Para mais informações, consulte o New-CMTSStepAppapplyOperatingSystem.
Insetos que foram corrigidos
Problemas de validação fixos com o parâmetro DestinationVariable para permitir valores que começam com um sublinhado ( _ ).
Alterações não-quebrando
Adicione o parâmetro LayeredDriver para suportar o controlador de teclado em camadas durante a implementação do SO.
New-CMTSStepUpgradeOperatingSystem
Para mais informações, consulte o Sistema operativo New-CMTSStepUpgrade .
Alterações não-quebrando
Adicione novo parâmetro SoftwareUpdate para especificar uma atualização de funcionalidade para o passo da sequência de tarefas de Upgrade OS.
Publish-CMPrestageContent
Para mais informações, consulte Publish-CMPrestageContent.
Insetos que foram corrigidos
Problema de objeto inválido potencial fixo.
Remove-CMApplicationGroup
Para obter mais informações, consulte Remove-CMApplicationGroup.
Insetos que foram corrigidos
Corrigiu um problema para obter o caminho correto do grupo de aplicações ao utilizar o pipeline.
Set-CMAntimalwarePolicy
Para mais informações, consulte Set-CMAntimalwarePolcy.
Alterações não-quebrando
Adicionou o parâmetro PuaProtection para suportar aplicações potencialmente indesejadas.
Set-CMApplicationDeployment
Para obter mais informações, consulte Set-CMApplicationDeployment.
Alterações não-quebrando
Adicione o parâmetro AutoCloseExecutable para permitir a definição de implementação da aplicação para comportamentos de instalação.
Set-CMClientSetting
Para obter mais informações, consulte Set-CMClientSetting.
Alterações não-quebrando
Adicionou uma mensagem de depreciação significativa para o parâmetro SoftwareMetering.
Set-CMClientSettingSoftwareUpdate
Para obter mais informações, consulte Set-CMClientSettingSoftwareUpdate.
Alterações não-quebrando
Adicionei o parâmetro EnableWsusCertPinning para suportar a fixação do certificado.
Set-CMDeploymentType
Para obter mais informações, consulte Set-CMDeploymentType.
Insetos que foram corrigidos
Corrigi um problema com o parâmetro AddRequirement para adicionar novas regras.
Set-CMMsiDeploymentType
Para obter mais informações, consulte Set-CMMsiDeploymentType.
Insetos que foram corrigidos
Atualize o tipo de implementação de acordo com o tipo instalador para evitar a reposição das configurações quando alterar a localização do conteúdo.
Alterações não-quebrando
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 não-quebrando
Adicionou novo parâmetro HighPerformance para suportar a definição de desempenho para a sequência de tarefas.
Set-CMTSStepApplyDriverPackage
Para obter mais informações, consulte Set-CMTSStepApplyDriverPackage.
Alterações não-quebrando
Adicionou uma condição para validar um pacote para o PackageId especificado .
Set-CMTSStepApplyOperatingSystem
Para obter mais informações, consulte Set-CMTSStepApplyOperatingSystem.
Insetos que foram corrigidos
Corrigiu um problema com o parâmetro Destino.
Alterações não-quebrando
Adicione o parâmetro LayeredDriver para suportar o controlador de teclado em camadas durante a implementação do SO.
Set-CMTSStepUpgradeOperatingSystem
Para obter mais informações, consulte Set-CMTSStepUpgradeOperatingSystem.
Alterações não-quebrando
Adicione novo parâmetro SoftwareUpdate para especificar uma atualização de funcionalidade para o passo da sequência de tarefas de Upgrade OS.
Start-CMDistributionPointUpgrade
Para obter mais informações, consulte Start-CMDistributionPointUpgrade.
Alterações interruptivas
Desafine o espaço livre mínimo predefinido para 500 MB.
Update-CMDistributionPoint
Para mais informações, consulte Update-CMDistributionPoint.
Insetos que foram corrigidos
Corrigiu um problema para atualizar o conteúdo tanto da instalação como da desinstalação das pastas quando são diferentes.
Como fornecer problemas de feedback ou relatório
Muitas das correções e melhorias descritas neste artigo são resultado do seu feedback.
Para enviar feedback, utilize a consola 'Gestor de Configuração'. Para obter mais informações, consulte feedback para PowerShell.
Para submeter novos pedidos de funcionalidade, consulte o grupo PowerShell do Gestor de Configuração no UserVoice.