Share via

Configuration Manager alterações da biblioteca de cmdlets para a versão 2103

  • Artigo

Aplica-se a: Configuration Manager (branch atual)

Estas notas de versão resumem as alterações na biblioteca de cmdlets Configuration Manager na versão 2103.

Observação

Configuration Manager Branch atual versão 2010 é a linha de base para essas alterações. Para obter mais informações, consulte Configuration Manager as alterações da biblioteca de cmdlets para a versão 2010.

Problema conhecido com a ajuda do PowerShell atualizável

Desde a versão 2010, é possível usar o cmdlet Update-Help para baixar as informações mais recentes para o módulo de PowerShell do Configuration Manager.

Na versão 2103, a estrutura do módulo do PowerShell mudou de 29 DLLs para dois. Os arquivos de ajuda XML do PowerShell são associados à DLL para os cmdlets. Portanto, o conteúdo da ajuda da versão 2010 é incompatível com um console da versão 2103, e o conteúdo da 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 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á o conteúdo com êxito em um console da versão 2010, mas Get-Help retornará apenas as informações de uso padrão. Esse comportamento ocorre porque o PowerShell não consegue encontrar as informações do cmdlet no arquivo XML correto, que é diferente agora. Antes do lançamento da versão 2103, se você usava Update-Help com um site da versão 2010, pode continuar a usar Get-Help agora.

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

Observação

Esse problema é exclusivo para a versão 2010. Devido a como a estrutura foi alterada, ela não deve ser um problema para as versões posteriores.

Módulo PowerShell

Se você importar manualmente o módulo ConfigurationManager e seu console do dispositivo ainda não estiver conectado a um site, 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 do PowerShell de ConfigurationManager requer Microsoft .NET versão 4.7.2 ou posterior.

Cmdlets que não são compatíveis com o PowerShell versão 7

Embora os cmdlets do Configuration Manager forneçam suporte geral para o PowerShell versão 7, os seguintes cmdlets 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 que é 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 alterações a seguir foram feitas nos cmdlets existentes nesta versão. As alterações podem ser novas funcionalidades, correções de bugs ou reprovação. Algumas alterações podem estar sendo interrompidas. Se você usar um dos cmdlets ou áreas de recursos listados nesta seção, examine atentamente as alterações para entender como elas podem afetar o 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. Propriedades lentas contêm valores que são relativamente ineficientes de 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 sem interrupção

Correção de um nome de parâmetro inconsistente.

Copy-CMCollection

Alterações sem interrupção

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

Get-CMDeploymentStatusDetails

Alterações sem interrupção

  • Correção de problema de validação de tipo de objeto de entrada para tipos como SMS_DCMDeploymentErrorStatus, SMS_DCMDeploymentNonCompliantStatus e SMS_DCMDeploymentCompliantStatus.
  • Correção de problema de tipo de classe inválido de saída alterando o tipo de objeto de saída de SMS_AppDeploymentRequirementsNotMetStatus para SMS_AppDeploymentRequirementsNotMetAssetDetails.
  • O tipo de objeto de saída foi alterado de SMS_AppDeploymentAssetDetails para SMS_AppDeploymentErrorAssetDetails para obter mais detalhes de erro.
  • Tipo de objeto de entrada adicionado SMS_UpdateDeploymentSummary para que esse cmdlet possa obter detalhes da 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 sem interrupção

Adicione a 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 sem interrupção

Pacote de parâmetros adicionado para recuperar o tipo de pacote específico.

Get-CMSoftwareUpdateDeployment

Alterações sem interrupção

Correção de um problema ao implantar atualizações sem pacote.

New-CMApplication

Bugs corrigidos

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

New-CMCertificateProfileScep

Bugs corrigidos

Problema de parâmetro SanType corrigido.

New-CMCollection

Alterações sem interrupção

Validação fixa com o parâmetro Name para alinhar com o console.

New-CMOperatingSystemImage

Alterações sem interrupção

Parâmetro de Índice adicionado. Quando esse parâmetro é adicionado, o site extrai uma única imagem 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 sem interrupção

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

New-CMTSRule

Alterações sem interrupção

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

New-CMTSStepConditionVariable

Alterações sem interrupção

O parâmetro OperatorType tem outro valor possível: NotLike

New-CMSoftwareUpdateAutoDeploymentRule

Alterações da falha

Problema no parâmetro O365LanguageSelection corrigido. Agora você precisa especificar um idioma com um nome de país. Essa alteração alinha o parâmetro com as opções no console do Configuration Manager. Por exemplo, -O365LanguageSelection "English (United States)"

Set-CMCertificateProfileScep

Bugs corrigidos

Problema de parâmetro SanType corrigido.

Set-CMClientPushInstallation

Alterações sem interrupção

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

Set-CMCollection

Alterações sem interrupção

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

Set-CMEmailProfile

Alterações sem interrupção

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

Set-CMFallbackStatusPoint

Alterações sem interrupção

Correção de um nome de parâmetro inconsistente.

Set-CMThirdPartyUpdateCatalog

Alterações sem interrupção

Adicione os 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 sem interrupção

Foi corrigido um problema com o parâmetro PublishOption definido como FullContent.

Set-CMTSStep*

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

Alterações sem interrupção

O parâmetro OperatorType tem outro valor possível: NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

Alterações da falha

Problema no parâmetro O365LanguageSelection corrigido. Agora você precisa especificar um idioma com um nome de país. Essa alteração alinha o parâmetro com as opções no console do Configuration Manager. Por exemplo, -O365LanguageSelection "English (United States)"

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 Configuration Manager. Para obter mais informações, consulte comentários do PowerShell.

Para enviar novas solicitações de recursos, consulte o grupo PowerShell de Configuration Manager no UserVoice.