Compartilhar via

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

  • Artigo

Observação

O System Center Configuration Current Branch 1706 é a linha de base para essas alterações. Consulte Configuration Manager alterações da Biblioteca de Cmdlets para o Branch Atual 1706 para obter mais detalhes.

Alterações importantes

Atualizações da biblioteca de documentação

Para obter a documentação mais recente da biblioteca de cmdlets, consulte Referência do módulo ConfigurationManager.

Cmdlets removidos

Os seguintes cmdlets não têm mais suporte e foram removidos:

  • Invoke-CMAmtProvisioningDiscovery
  • New-CMAmtProvisioningAccount
  • Set-CMPowerControl

Cmdlets preteridos

  • Invoke-CMEndpointProtectionScan e Save-CMEndpointProtectionDefinition foram substituídos por Invoke-CMClientAction.

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 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 isso, 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

Estes são problemas conhecidos com a Biblioteca cmdlet que não são resolvidos nesta versão.

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 Import-Module isso é chamado no arquivo e não no ConfigurationManager.psd1 caminho lógico ou no nome do módulo.

Get-CMSiteUpdateInstallStatus

O cmdlet pode falhar com um erro WqlQueryException.

Solução alternativa

  • Use Invoke-CMWmiQuery para consultar diretamente a classe SMS_CM_UpdatePackTopLevelMonitoring.
Exemplo
# Note: The PackageGuid value can be determined by running Get-CMSiteUpdateInstallStatus -Verbose and viewing the query details.
Invoke-CMWmiQuery "SELECT * FROM SMS_UpdatePackTopLevelMonitoring WHERE PackageGuid='...' ORDER BY StageId ASC"

Set-CMSoftwareUpdatePoint

As alterações no Agendamento podem não ser refletidas 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

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

Cmdlets de associação de dispositivo

Get-CMResultantCollection obterá as coleções associadas a um dispositivo. Get-CMResultantDeployment obterá as implantações direcionadas a um dispositivo.

Gerenciamento de classe de inventário do cliente

Novos cmdlets foram adicionados para dar suporte à modificação de classes de inventário usadas para o inventário do cliente.

  • Get-CMInventoryClass
  • New-CMInventoryReportClass

Sequências 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)
    • CMTaskSequenceStepApplyOperatingSystem
    • CMTaskSequenceStepApplyWindowsSetting

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

Observe que, 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. Observe que os 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 normalmente se manifestam por trabalhar com conjuntos muito grandes de objetos provedores de SMS ou em ambientes de execução muito longos

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 e podem estar quebrando. Se você usar um dos cmdlets ou áreas de recursos listadas nesta seção, examine cuidadosamente as alterações para entender como elas podem afetar seu uso.

Configuração de conformidade e cmdlets de regra

Bugs corrigidos

O valor RuleDescription pode não se aplicar à Regra. (Cmdlets que dão suporte à criação ou modificação de regra)

Não é possível definir o valor para a chave de registro "padrão" (Add/Set-CMComplianceSettingRegistryKeyValue, New-CMDetectionClauseRegistryKeyValue).

NullReferenceException pode ser gerado (New-CMComplianceRuleAssembly)

Suporte a DataType ausente (Add-CMComplientSettingREgistryKeyValue)

Add-CMApplicationCatalogWebsitePoint

Bugs corrigidos

Melhor tratamento de erros e relatórios.

Add/Set-CMDataWarehouseServicePoint

Alterações sem interrupção

O DataWarehouseSqlPort dá suporte ao valor da porta de 1 a 65535. O parâmetro DaysOfWeek agora dá suporte ao valor de Daily.

Add/Set-CMExchangeServer

Bugs corrigidos

O valor do parâmetro EmailAddress pode não se aplicar à configuração do servidor do Exchange.

Add-CMMsiDeploymentType

Bugs corrigidos

O parâmetro ContentLocation é necessário ao usar a detecção de script. Adicionaram novos parâmetros UninstallContentLocation e UninstallOption .

Alterações sem interrupção

Validação aprimorada para o parâmetro ProductCode .

Add-CMScriptDeploymentType

Alterações sem interrupção

Validação aprimorada para o parâmetro ProductCode . Adicionaram novos parâmetros UninstallContentLocation e UninstallOption .

Get-CMDeploymentTypeDependencyGroup

Alterações sem interrupção

O cmdlet agora dá suporte ao valor pipelined de Get-CMDeploymentType.

Get-CMSiteStatusMessage

Bugs corrigidos

Nem todas as mensagens são retornadas ao filtrar com o parâmetro Severity .

Invoke-CMClientAction (anteriormente Invoke-CMClientNotification)

Alterações sem interrupção

Parâmetro ActionType que aceita todos os tipos de notificação do cliente.

Observação

RequestScriptExecution não há suporte neste momento.

Preterições

NotificationType foi substituído pelo ActionType

Implantação new-CM*

Bugs corrigidos

O cmdlet permite a combinação de parâmetros CollectionId, CollectionName e Collection que podem levar a um comportamento indefinido.

New-CMBootableMedia

Bugs corrigidos

Não é possível criar mídia como SiteBased.

New-CMWirelessProfile

Bugs corrigidos

O cmdlet não é executado em um ambiente do PowerShell de 64 bits.

O cmdlet poderá retornar um erro se especificar um valor para o parâmetro ClientCertificate .

Remove-CMCorpOwnedDevice

Bugs corrigidos

Não é possível remover o dispositivo ao usar o objeto pipelined.

O nome do dispositivo não é relatado ao usar WhatIf ou Confirmar.

Remove-CMStateMigrationPoint

Alterações quebrando

Será necessária confirmação adicional se houver dados de usuário armazenados no ponto de migração de estado. Observação: a força ignorará essa confirmação.

Save-CMSoftwareUpdate

Alterações sem interrupção

Adicionaram parâmetros RetryCount e RetryDelaySec para reattempt downloads após uma falha.

Set-CMAccessAccount

Bugs corrigidos

PassThru pode não retornar um objeto atualizado.

Set-CMAntimalwarePolicy

Bugs corrigidos

Não é possível usar caracteres curinga com o parâmetro AddExcludedFilePath .

Não é possível configurar FallbackOrder para uma determinada política

Alterações sem interrupção

Adicionaram novos parâmetros para gerenciar listas de ameaças: AddThreat, RemoveThreat e CleanThreat. AddThreat aceita um hashtable com a chave sendo o nome e o valor sendo do tipo Microsoft.ConfigurationManagement.Cmdlets.EP.Commands.DefaultActionMediumAndLowType.

Preterições

Os parâmetros ThreatName e OverrideAction foram substituídos por AddThreat, RemoveThreat e CleanThreat.

Set-CMClientSettingComputerAgent

Preterições

Parâmetro HealthAttestationUrl , pois ele não é mais utilizado pelo produto.

Set-CMClientSettingHardwareInventory

Alterações sem interrupção

Os parâmetros AddInventoryReportClass, CleanInventoryReportClass e RemoveInventoryReportClass dão suporte à modificação do inventário de hardware coletado pelos clientes.

Set-CMMsiDeploymentType

Alterações sem interrupção

Validação aprimorada para o parâmetro ProductCode .

Set-CMScriptDeployment

Bugs corrigidos

O objeto de aplicativo no Provedor de SMS pode não ser desbloqueado automaticamente se o cmdlet falhar impedindo novas modificações até que o bloqueio expire.

Set-CMScriptDeploymentType

Alterações sem interrupção

Validação aprimorada para o parâmetro ProductCode .

Set-CMSoftwareUpdatePointComponent

Alterações sem interrupção

Adicionou um novo parâmetro ContentFileOption para configurar o comportamento de download de atualização.

Set-CMSiteMaintenanceTask

Alterações sem interrupção

Relatórios de erros aprimorados

Set-CMWirelessProfile

Bugs corrigidos

O cmdlet não é executado em um ambiente do PowerShell de 64 bits.

Erro incompatívelPSTypeName pode ser gerado ao usar o pipeline de objeto.

ProxyAddress e ProxyPort não validam o uso das mesmas regras que o console Configuration Manager.

Especificar ProxyAddress sem ProxyPort pode fazer com que uma configuração inválida seja criada.

SecurityAuthentication pode ser alterado com configurações que não dão suporte a isso.

O EapType deve ser combinado com SecurityAuthentication mesmo quando este não estiver sendo alterado.

Alterações sem interrupção

Adicionaram parâmetros RootCertificate, ClientCertificate e RememberCredentials .

Funcionalidade aprimorada para configurar uma política sem fio MSCHAPv2.

Sync-CMSoftwareUpdate

Alterações sem interrupção

O cmdlet não exige mais que nenhum parâmetro seja especificado.

Observação

Quando nenhum parâmetro é definido, -ForceSync $true está implícito.