Compartilhar via

Configuration Manager alterações na Biblioteca de Cmdlets para o Branch Atual 1802

  • Artigo

Observação

O System Center Configuration Current Branch 1710 é a linha de base para essas alterações. Para obter mais informações, consulte Configuration Manager alterações da Biblioteca de Cmdlets para o Branch Atual 1710.

Alterações importantes

O instalador do console de administrador foi atualizado para permitir a importação do módulo ConfigurationManager por nome lógico sem usar um link rígido de <installdir>\bin\ConfigurationManager para <installdir>\bin.

Cmdlets preteridos

Desabilitar a criação automática do PSDrive

Quando o módulo ConfigurationManager.psd1 é carregado, o PowerShell tenta criar automaticamente uma conexão com o último Provedor de SMS que foi acessado usando o console Configuration Manager. Em alguns cenários, esse comportamento de conexão pode não ser desejável. Foi adicionada uma chave de registro por usuário que pode desabilitar esse comportamento e exigir a criação de unidade manual. Para configurar o comportamento, use a chave do registro: HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell e defina o valor DisableCMDriveAutoCreate como um DWORD de 1 (a criação automática da unidade está desabilitada) ou 0 (comportamento padrão). A exclusão DisableCMDriveAutoCreate também habilita o comportamento padrão.

Observação

Quando a criação automática da unidade é desabilitada, o console Configuration Manager pode relatar um erro ao iniciar uma janela do PowerShell.

Problemas conhecidos

Os itens a seguir são problemas conhecidos com a Biblioteca de Cmdlet que não são resolvidos nesta versão.

New-CMCloudDistributionPoint

No momento, o cmdlet não é funcional.

Solução alternativa

  • Nenhum

Get-CMAadConditionalAccessPolicy e Set-CMAadConditionalAccessPolicy

O ambiente do PowerShell de 64 bits é necessário para esses cmdlets.

Solução alternativa

  • Nenhum

Import-CMSecurityRole

O cmdlet pode falhar com um erro directoryNotFoundException localizando o arquivo SecuredRoles.xsd.

Solução alternativa

  • Verifique se isso Import-Module é chamado no arquivo e não no ConfigurationManager.psd1 caminho lógico ou no nome do módulo.

Set-CMSoftwareUpdatePoint

As alterações no Agendamento podem não ser mostradas no console Configuration Manager, embora o objeto provedor de SMS subjacente tenha sido alterado.

Solução alternativa

  • Desista e relançar o console Configuration Manager.

Novos cmdlets

Os itens a seguir são cmdlets recém-adicionados para esta versão que adicionam novas funcionalidades ou aprimoram a funcionalidade dos cmdlets existentes.

cmdlets Co-Management

New-CMCoManagementPolicy permitirá a criação de uma política de cogerenciamento.

Cmdlets de condição global

Novos cmdlets foram adicionados para dar suporte à criação e modificação de condições globais. Há suporte para verbos novos e set.

  • CMGlobalConditionActiveDirectoryQuery
  • CMGlobalConditionAssembly
  • CMGlobalConditionFile
  • CMGlobalConditionIisMetabase
  • CMGlobalConditionRegistryKey
  • CMGlobalConditionRegistryValue
  • CMGlobalConditionScript
  • CMGlobalConditionSqlQuery
  • CMGlobalConditionWqlQuery
  • CMGlobalConditionXPathQuery
  • CMGlobalConditionOmaUri

Cmdlets de sequência de tarefas

Novos cmdlets foram adicionados para dar suporte à modificação de etapas da sequência de tarefas.

  • Comandos de sequência de tarefas (Obter, Novo, Remover e Definir verbos com suporte)

    • CMTSCaptureNetworkSettings
    • CMTSCaptureSystemImage
    • CMTSCaptureUserState
    • CMTSCaptureWindowsSetting
    • CMTSConvertDisk
    • CMTSDisableBitLocker
    • CMTSEnableBitLocker
    • CMTSPrepareSmsClient
    • CMTSPrepareWindows
    • CMTSStepApplyDataImage
    • CMTSStepDownloadPackageContent
    • CMTSStepJoinDomainWorkgroup
    • CMTSStepOfflineEnableBitLocker
    • CMTSStepPrestartCheckAction
    • CMTSStepRestoreUserState
    • CMTSStepUpgradeOperatingSystem

  • Comandos de condição de sequência de tarefas

    • New-CMTSStepConditionOperatingSystemLanguage cmdlet para criação de uma condição de linguagem do sistema operacional.

  • Cmdlets de cópia de sequência de tarefas

    • Copy-CMTaskSequence cmdlet para criar uma cópia de uma sequência de tarefas existente.

Convert-CMDeploymentType

Esse cmdlet permite obter um objeto nativo DeploymentType de uma SMS_DeploymentType instância de objeto WMI. Pode ser combinado com Get-CMDeploymentType.

Controle e recuperação de recursos (BETA)

Novos cmdlets foram adicionados para dar suporte ao acompanhamento de objetos do Provedor de SMS usados pelo runtime do PowerShell e para limpar esses recursos quando eles não forem mais necessários.

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

Quando Start-CMObjectTracking for executado, o runtime do PowerShell acompanhará IResultObject objetos criados por cmdlets da Biblioteca de Cmdlet. Cmdlets que não são limpos manualmente com .Dispose() podem ser recuperados usando Disconnect-CMTrackedObject em um objeto individual.

Exemplo

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

Depois que um objeto é recuperado, ele não pode mais ser reutilizado ou passado para outro cmdlet por meio do pipeline de objeto.

Stop-CMObjectTracking pode ser usado para desativar o rastreamento de objetos. Objetos alocados anteriormente permanecerão ativos.

Recursos não reclamados podem fazer com que erros de violação de cota sejam gerados pelo provedor de SMS. Esses problemas de cota normalmente se manifestam por trabalhar com grandes conjuntos de objetos provedores de SMS ou em ambientes de execução longa.

Observação

Este é um recurso experimental e pode estar sujeito a alterações ou remoção em uma versão futura. Esse recurso é opt-in e não está habilitado por padrão.

Alterações de cmdlet

As seguintes alterações foram feitas em cmdlets existentes para esta versão. As alterações podem ser novas funcionalidades, correções de bugs ou preterimentos. Algumas alterações podem estar quebrando. Se você usar um dos cmdlets ou áreas de recursos listados nesta seção, examine cuidadosamente as alterações para entender como elas podem afetar seu uso.

PowerShell ISE

Bugs corrigidos

Powershell_ise.exe processo pode falhar na saída quando o log verbose estiver habilitado globalmente e o módulo ConfigurationManager tiver sido importado.

Cmdlets de sequência de tarefas

Bugs corrigidos

  • New-CMTSRule
    • O cmdlet poderá falhar se um SecureString tipo de variável for usado.
  • New-CMTSStepApplyOperatingSystem e Set-CMTSStepApplyOperatingSystem
    • Não é possível especificar um valor nulo para DestinationLogicalDrive.
    • O valor de minúscula para DestinationLogicalDrive pode causar uma falha de validação da interface do usuário.
  • New-CMTSStepApplyWindowsSetting e Set-CMTSStepApplyWindowsSetting
    • O uso do parâmetro de senha pode causar um erro no Provedor de SMS.
  • New-CMTSStepInstallSoftware e Set-CMTSStepInstallSoftware
    • O cmdlet permite a combinação incorreta de parâmetros Program e EnableContinueOnInstallError .

Alterações sem interrupção

Validação de parâmetro aprimorada.

Add-CMComplianceSettingRegistryKeyValue

Bugs corrigidos

ExpressionValue não dá suporte a todas as combinações de configurações com ExpressionOperator. Corrigir comportamentos não consistentes com o console de administrador.

Alterações sem interrupção

Parâmetro RemediarDword adicionado para dar suporte a um valor inteiro para correção.

Add-CMManagementPoint

Alterações sem interrupção

Validação de parâmetro aprimorada.

Add-CMMsiDeploymentType

Bugs corrigidos

O cmdlet não valida para o uso correto de combinações de parâmetro UninstallContentLocation e UninstallOption .

Add-CMScriptDeploymentType

Bugs corrigidos

O cmdlet requer incorretamente o uso do parâmetro Script ao usar AddDetectionClause.

Add-CMSoftwareUpdatePoint

Bugs corrigidos

O cmdlet pode retornar um erro ao adicionar um ponto de atualização de software a um sistema remoto.

Enable-CMSiteFeature

Bugs corrigidos

Se os recursos de pré-lançamento não estiverem habilitados para a hierarquia, o cmdlet falhará com uma mensagem de erro formatada incorretamente.

Get-CMApplication

Alterações quebrando

Os aplicativos ocultos agora não estão mais incluídos por padrão. O parâmetro ShowHidden foi adicionado para forçar a exibição de aplicativos ocultos no conjunto de resultados.

Get-CMSiteInstallStatus

Bugs corrigidos

O cmdlet pode executar uma consulta inválida no Provedor de SMS.

Get-CMSiteStatusMessage

Bugs corrigidos

A consulta de mensagem de status pode retornar mensagens duplicadas.

New-CMBootableMedia

Bugs corrigidos

O parâmetro DistributionPoint não ignora pontos de distribuição habilitados para nuvem.

New-CMComplianceRuleFileFolderSize

Alterações sem interrupção

Validação de parâmetro aprimorada.

New-CMDetectionClauseMacPackage

Bugs corrigidos

Validação de parâmetro aprimorada.

New-CMDetectionClauseWindowsInstaller

Bugs corrigidos

O valor productcode não é aplicado corretamente ao objeto Setting.

New-CMExchangeServer

Alterações sem interrupção

Os parâmetros FullSyncSchedule ou DeltaSyncMins não são mais obrigatórios e aplicarão um agendamento padrão se não forem usados.

New-CMInventoryReportClass**

Alterações sem interrupção

Parâmetro de nome adicionado para definir o nome da classe.

New-CMPrestagedMedia

Bugs corrigidos

O cmdlet falha ao especificar um arquivo de saída com uma extensão .wim.

New-CMProgram

Bugs que foram arquivados

O valor do parâmetro ProgramRunType pode ser aplicado incorretamente ao Programa.

New-CMSchedule

Bugs corrigidos

RecurCount não deve permitir um valor de 0.

New-CMStandaloneMedia

Bugs corrigidos

O cmdlet pode falhar ao criar mídia se MediaType for Usb.

Alterações sem interrupção

Validação de parâmetro aprimorada.

New-CMStatusFilterRule

Alterações sem interrupção

Validação de parâmetro aprimorada.

New-CMStorageFolder

Alterações sem interrupção

Validação de parâmetro aprimorada.

New-CMTaskSequenceDeployment

Bugs corrigidos

O cmdlet pode adicionar dois agendamentos quando ScheduleEvent for usado.

New-CMWirelessProfile

Alterações sem interrupção

Validação de parâmetro aprimorada.

Publish-CMPrestageContent

Bugs corrigidos

Aplicativo/Applicationname/ O uso do parâmetro ApplicationId pode fazer com que o cmdlet falhe.

Alterações sem interrupção

Melhorias de desempenho.

Set-CMAntimalwarePolicy

Bugs corrigidos

AddExcludedFilePath não cria regras de exclusão padrão.

Set-CMApplication

Bugs corrigidos

Modificar um aplicativo com vários idiomas de exibição pode causar alterações inesperadas no estado do aplicativo.

Alterações sem interrupção

Os parâmetros AddAppCategory, AddUserCategory, RemoveAppCategory, RemoveUserCategory, CleanAppCategory e CleanUserCategory foram adicionados para dar suporte à adição de categorias de aplicativo por objeto.

Preterições

Os parâmetros AppCategory e UserCategory foram substituídos pelo novo [Add| Remover| Clean]AppCategory e [Add| Remover| Limpar]Parâmetros userCategory.

Set-CMBoundary

Bugs corrigidos

O parâmetro NewName está ausente.

Alterações sem interrupção

Validação de parâmetro aprimorada.

Set-CMClientSettingClientcache

Preterições

O parâmetro EnableHttps não tem mais suporte.

Set-CMManagementPoint

Alterações sem interrupção

Validação de parâmetro aprimorada.

Set-CMMsiDeploymentType

Bugs corrigidos

O cmdlet não valida para o uso correto de combinações de parâmetro UninstallContentLocation e UninstallOption .

Set-CMPackage

Bugs corrigidos

O parâmetro UseMeteredNetwork está ausente.

Set-CMSoftwareInventory

Alterações sem interrupção

Parâmetros CleanTag1, CleanTag2, CleanTag3 adicionados para dar suporte à remoção de marcas.

ParentSoftwareId, parâmetros CategoryId adicionados.

Validação de parâmetro aprimorada.

Set-CMStatusFilterRule

Alterações sem interrupção

Validação de parâmetro aprimorada.

Set-CMUserDataAndProfileConfigurationItem

Alterações sem interrupção

Validação de parâmetro aprimorada.

Set-CMWirelessProfile

Alterações sem interrupção

Melhor validação de parâmetro em torno de vários cenários de criação de perfil.