Alterações na biblioteca de cmdlets do Gerenciador de Configurações para a versão 2103

Aplica-se a: Gerenciador de Configurações (branch atual)

Estas notas de versão resumem as alterações na biblioteca de cmdlets do Gerenciador de Configurações na versão 2103.

Observação

A versão 2010 do branch atual do Gerenciador de Configurações é a linha de base para essas alterações. Para obter mais informações, consulte Alterações na biblioteca de cmdlets do Gerenciador de Configurações para a versão 2010.

Problema conhecido com a ajuda atualizável do PowerShell

A partir da versão 2010, você pode usar o cmdlet Update-Help para baixar as informações mais recentes do módulo do PowerShell do Gerenciador de Configurações.

Na versão 2103, a estrutura do módulo do PowerShell mudou de 29 DLLs para duas. Os arquivos de ajuda XML do PowerShell estão associados à DLL para os cmdlets. Portanto, o conteúdo de ajuda da versão 2010 é incompatível com um console da versão 2103, e o conteúdo de ajuda da versão 2103 é incompatível com um console da versão 2010.

Devido a essa alteração na forma como o conteúdo atualizável é estruturado e publicado com o lançamento da versão 2103, não use a Update-Help em um site da versão 2010. Atualize o site para a versão 2103 e atualize o conteúdo de ajuda local.

O cmdlet baixará com êxito o conteúdo em um console versão 2010, mas o Get-Help retornará apenas informações de uso padrão. Esse comportamento ocorre porque o PowerShell não consegue encontrar as informações de cmdlet no arquivo XML correto, o que é diferente agora. Antes do lançamento da versão 2103, se você usava a Update-Help com um site da versão 2010, pode continuar a usar Get-Help agora.

Da mesma forma, se você usou a Update-Help em um site da versão 2010, depois de atualizar para a versão 2103, execute a Update-Help novamente para obter a versão compatível do conteúdo de ajuda. Caso contrário, Get-Help retornará apenas informações de uso padrão.

Observação

Esse problema é exclusivo da versão 2010. Devido à forma como a estrutura mudou, isso não deve ser um problema para versões posteriores.

Módulo do PowerShell

Se o console do Gerenciador de Configurações no dispositivo ainda não tiver se conectado a um site, se você importar manualmente o módulo ConfigurationManager, ele criará uma unidade do PowerShell para o site com base no provedor de SMS padrão.

A partir da versão 2103, o módulo ConfigurationManager PowerShell requer o Microsoft .NET versão 4.7.2 ou posterior.

Cmdlets que não dão suporte ao PowerShell versão 7

Embora os cmdlets do Gerenciador de Configurações forneçam suporte geral para o PowerShell versão 7, os cmdlets a seguir não dão suporte ao PowerShell 7:

  • Import-CMPackage
  • Import-CMDriverPackage
  • Import-CMTaskSequence
  • Export-CMPackage
  • Export-CMDriverPackage
  • Export-CMTaskSequence

Eles exigem o .NET Framework, em vez do .NET Core, usado com o PowerShell versão 7.

A partir da versão 2103, se você tentar usar esses cmdlets em uma sessão do PowerShell versão 7, eles falharão com o seguinte erro: This cmdlet only supports the ".NET Framework" runtime.

Novos cmdlets

Alterações de cmdlet

As seguintes alterações foram feitas nos cmdlets existentes nesta versão. As alterações podem ser novas funcionalidades, correções de bugs ou substituição. Algumas alterações podem estar falhando. 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.

Suporte rápido

Os cmdlets a seguir agora dão suporte ao parâmetro Fast . Use esse parâmetro para não atualizar automaticamente as propriedades lentas. As propriedades lentas contêm valores relativamente ineficientes para recuperar. Obter essas propriedades pode causar mais tráfego de rede e afetar o desempenho do cmdlet.

  • Get-CMAlert
  • Get-CMAlertSubscription
  • Get-CMBaseline
  • Get-CMBaselineDeployment
  • Get-CMBaselineDeploymentStatus
  • Get-CMClientCertificatePfx
  • Get-CMComplianceRule
  • Get-CMComplianceSetting
  • Get-CMConfigurationPlatform
  • Get-CMConfigurationPolicyDeployment
  • Get-CMDriver
  • Get-CMDriverPackage
  • Get-CMTaskSequence
  • Get-CMTaskSequenceDeployment

Add-CMFallbackStatusPoint

Alterações interruptivas

Corrigido um nome de parâmetro inconsistente.

Copy-CMCollection

Alterações interruptivas

Validação corrigida com o parâmetro NewName para alinhar com o console.

Get-CMDeploymentStatusDetails

Alterações interruptivas

  • Correção do problema de validação do tipo de objeto de entrada para tipos como SMS_DCMDeploymentErrorStatus, SMS_DCMDeploymentNonCompliantStatus e SMS_DCMDeploymentCompliantStatus.
  • Corrigido o problema de tipo de classe inválido de saída alterando o tipo de objeto de saída SMS_AppDeploymentRequirementsNotMetStatus para SMS_AppDeploymentRequirementsNotMetAssetDetails.
  • Alterado o tipo de objeto de saída de SMS_AppDeploymentAssetDetails para SMS_AppDeploymentErrorAssetDetails para obter mais detalhes do erro.
  • Adicionado um tipo de objeto de entrada SMS_UpdateDeploymentSummary para que este cmdlet possa obter detalhes de implantação de atualização. Ao passar a saída de Get-CMSoftwareUpdateDeploymentStatus para Get-CMDeploymentStatusDetails, ele retorna detalhes de implantação de SMS_SUMDeploymentAssetDetails.

Get-CMDriver

Alterações interruptivas

Adicionar capacidade de filtrar por parâmetro AdministrativeCategory.

$category1 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 1'
$category2 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 2'
$categories = $category1,$category2

Get-CMDriver -AdministrativeCategory $categories

Get-CMPackage

Alterações interruptivas

Parâmetro PackageType adicionado para recuperar um tipo de pacote específico.

Get-CMSoftwareUpdateDeployment

Alterações interruptivas

Corrigido um problema ao implantar atualizações sem pacote.

New-CMApplication

Bugs que foram corrigidos

Foi corrigido um problema de exibição do Centro de Software ao instalar aplicativos criados com o formato de hora "aaaa/MM/dd".

New-CMCertificateProfileScep

Bugs que foram corrigidos

Corrigido um problema para o parâmetro SanType.

New-CMCollection

Alterações interruptivas

Validação corrigida com o parâmetro Nome para alinhar com o console.

New-CMOperatingSystemImage

Alterações interruptivas

Índice de parâmetro adicionado. Quando você adiciona esse parâmetro, o site extrai uma única imagem de índice de uma imagem de vários índices. Em seguida, ele coloca a nova imagem na mesma pasta de origem da imagem original.

New-CMOperatingSystemInstaller

Alterações interruptivas

Índice de parâmetro adicionado. Quando você adiciona esse parâmetro, o site substitui a imagem de vários índices atual por uma nova imagem de índice único.

New-CMTSRule

Alterações interruptivas

Parâmetro ReferencedVariableOperator tem outro valor possível: NotLike.

New-CMTSStepConditionVariable

Alterações interruptivas

Parâmetro OperatorType tem outro valor possível:NotLike

New-CMSoftwareUpdateAutoDeploymentRule

Alterações interruptivas

Correção de um problema para o parâmetro O365LanguageSelection. Agora você precisa especificar um idioma com um nome de país/região. Essa alteração alinha esse parâmetro com as opções no console do Gerenciador de Configurações. Por exemplo, -O365LanguageSelection "English (Estados Unidos)"

Set-CMCertificateProfileScep

Bugs que foram corrigidos

Corrigido um problema para o parâmetro SanType.

Set-CMClientPushInstallation

Alterações interruptivas

Adicione o parâmetro AllownNTLMFallback para habilitar o fallback NTLM.

Set-CMCollection

Alterações interruptivas

Validação corrigida com o parâmetro NewName para alinhar com o console.

Set-CMEmailProfile

Alterações interruptivas

  • Corrigido o problema com o parâmetro NewName ao especificar sAMAccountName como o nome de usuário da conta.
  • Corrigido um problema de parâmetro ao resolver DomainName.

Set-CMFallbackStatusPoint

Alterações interruptivas

Corrigido um nome de parâmetro inconsistente.

Set-CMThirdPartyUpdateCatalog

Alterações interruptivas

Adicionar parâmetros CategoryNamePublishOption e CategoryIdPublishOption. Use esses parâmetros para definir a opção de publicação de categoria ao assinar um catálogo v3.

$id = "5768207d-6c40-465b-ad65-50501661368f"
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$idOptionPair = @{$id = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName 'pmp' -CategoryIdPublishOption $idOptionPair -Subscribe -Force

$name = "2BrightSparks"
$name1 = "8x8, Inc."
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$nameOptionPair = @{$name = $option; $name1 = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName pmp -CategoryNamePublishOption $nameOptionPair -Subscribe -Force

Set-CMThirdPartyUpdateCategory

Alterações interruptivas

Correção de um problema com o parâmetro PublishOption definido como FullContent.

Set-CMTSStep*

Por exemplo, Set-CMTSStepApplyDataImage e os outros 34 cmdlets semelhantes.

Alterações interruptivas

Parâmetro OperatorType tem outro valor possível:NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

Alterações interruptivas

Correção de um problema para o parâmetro O365LanguageSelection. Agora você precisa especificar um idioma com o nome de um país. Essa alteração alinha esse parâmetro com as opções no console do Gerenciador de Configurações. Por exemplo, -O365LanguageSelection "English (Estados Unidos)"

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 console do Gerenciador de Configurações. Para obter mais informações, consulte Comentários para o PowerShell.

  • Last updated on