Partilhar via

Alterações na biblioteca cmdlet do Gestor de Configuração para a versão 2103

  • Artigo

Aplica-se a: Gestor de Configuração (ramo atual)

Estas notas de lançamento resumem as alterações à biblioteca cmdlet do Gestor de Configuração na versão 2103.

Nota

A versão atual do bloco de configuração 2010 é 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 2010.

Problema conhecido com ajuda powershell atualização

A partir da versão 2010, pode utilizar o cmdlet Update-Help para descarregar as informações mais recentes para o módulo PowerShell do Gestor de Configuração.

Na versão 2103, a estrutura do módulo PowerShell passou de 29 DLLs para dois. Os ficheiros de ajuda PowerShell XML estão associados ao DLL para os cmdlets. Assim, a versão 2010 ajuda o conteúdo é incompatível com uma consola versão 2103, e a versão 2103 ajuda o conteúdo é incompatível com uma consola de versão 2010.

Devido a esta alteração na forma como o conteúdo atualização é estruturado e publicado com o lançamento da versão 2103, não utilize o Update-Help num site de versão 2010. Atualize o site para a versão 2103 e, em seguida, atualize o conteúdo da ajuda local.

O cmdlet irá descarregar com sucesso conteúdos numa consola de versão 2010, mas o Get-Help apenas devolverá informações de utilização predefinidos. Este comportamento é porque o PowerShell não é capaz de encontrar a informação de cmdlet no ficheiro XML certo, o que é diferente agora. Antes do lançamento da versão 2103, se utilizar a Actualização-Ajuda com um site de versão 2010, pode continuar a utilizar o Get-Help agora.

Da mesma forma, se usou o Update-Help num site da versão 2010, depois de atualizar para a versão 2103, volte a executar a Actualização-Ajuda para obter a versão compatível do conteúdo de ajuda. Caso contrário, a Get-Help só devolverá as informações de utilização predefinidos.

Nota

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

Módulo PowerShell

Se a consola Do Gestor de Configuração do dispositivo ainda não tiver sido ligada a um site, se importar manualmente o módulo ConfigurationManager, cria uma unidade PowerShell para o site com base no Fornecedor de SMS predefinido.

A partir da versão 2103, o módulo PowerShell De Configuração requer a versão 4.7.2 ou posterior da Microsoft .NET.

Cmdlets que não suportam a versão 7 do PowerShell

Enquanto os cmdlets do Gestor de Configuração fornecem suporte geral para a versão 7 do PowerShell,os cmdlets seguintes não suportam o PowerShell 7:

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

Exigem o Quadro .NET em vez de .NET Core que é usado com a versão 7 do PowerShell.

A partir da versão 2103, se tentar utilizar estes cmdlets numa sessão da versão 7 da PowerShell, eles falham com o seguinte erro: This cmdlet only supports the ".NET Framework" runtime.

Novos cmdlets

Alterações do Cmdlet

Foram feitas as seguintes alterações aos cmdlets existentes nesta versão. As alterações podem ser novas funcionalidades, correções de erros ou depreciação. 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.

Suporte rápido

Os cmdlets seguintes suportam agora o parâmetro Fast. Utilize este parâmetro para não atualizar automaticamente as propriedades preguiçosas. As propriedades preguiçosas contêm valores que são relativamente ineficientes de recuperação. Obter estas 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 não-quebrando

Fixou um nome de parâmetro inconsistente.

Copy-CMCollection

Alterações não-quebrando

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

Get-CMDeploymentStatusDetails

Alterações não-quebrando

  • Problema de validação do tipo de objeto de entrada fixo para tipos como SMS_DCMDeploymentErrorStatus, SMS_DCMDeploymentNonCompliantStatus e SMS_DCMDeploymentCompliantStatus.
  • Problema de tipo de classe inválido de saída fixa alterando o tipo de objeto de saída SMS_AppDeploymentRequirementsNotMetStatus para SMS_AppDeploymentRequirementsNotMetAssetDetails.
  • Alterou o tipo de objeto de saída de SMS_AppDeploymentAssetDetails para SMS_AppDeploymentErrorAssetDetails para obter mais detalhes de erro.
  • Adicionei um tipo de objeto de entrada SMS_UpdateDeploymentSummary para que este cmdlet possa obter detalhes de implementação de atualização. Ao passar a saída da Get-CMSoftwareUpdateDeploymentStatus para Get-CMDeploymentStatusDetails, retorna os detalhes da implementação de SMS_SUMDeploymentAssetDetails.

Get-CMDriver

Alterações não-quebrando

Adicionar capacidade de filtragem por parâmetroS ACategoria Administrativa.

$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 não-quebrando

Parâmetro de parâmetro AdicionadoType para a recuperação do tipo de pacote específico.

Get-CMSoftwareUpdateDeployment

Alterações não-quebrando

Corrigiu um problema ao implementar atualizações sem pacote.

New-CMApplication

Insetos que foram corrigidos

Corrigiu um problema de exibição do Software Center ao instalar aplicações criadas com o formato de tempo "yyyy/MM/dd".

New-CMCertificateProfileScep

Insetos que foram corrigidos

Corrigiu um problema para o parâmetro SanType.

New-CMCollection

Alterações não-quebrando

Validação fixa com parâmetro Nome para alinhar com consola.

New-CMOperatingSystemImage

Alterações não-quebrando

Índice de parâmetro adicionado. Quando adiciona este parâmetro, o site extrai uma única imagem de índice a partir de uma imagem multi-índice. Em seguida, coloca a nova imagem na mesma pasta de origem que a imagem original.

New-CMOperatingSystemInstaller

Alterações não-quebrando

Índice de parâmetro adicionado. Quando adiciona este parâmetro, o site substitui a imagem multi-índice atual por uma nova imagem de índice único.

New-CMTSRule

Alterações não-quebrando

Parâmetro ReferênciaVariableOperator tem outro valor possível: NotLike .

New-CMTSStepConditionVariable

Alterações não-quebrando

O Operador de ParâmetroType tem outro valor possível:NotLike

New-CMSoftwareUpdateAutoDeploymentRule

Alterações interruptivas

Corrigiu um problema para o parâmetro O365LanguageSelection. Agora precisa especificar uma língua com um nome de país. Esta alteração alinha este parâmetro com as opções na consola 'Gestor de Configuração'. Por exemplo, -O365LanguageSelection "English (United States)"

Set-CMCertificateProfileScep

Insetos que foram corrigidos

Corrigiu um problema para o parâmetro SanType.

Set-CMClientPushInstallation

Alterações não-quebrando

Adicione o parâmetro AllownNTLMFallback para ativar o recuo do NTLM.

Set-CMCollection

Alterações não-quebrando

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

Set-CMEmailProfile

Alterações não-quebrando

  • Problema fixo com o parâmetro NewName quando especificar sAMAccountName como nome de utilizador da conta.
  • Corrigiu um problema de parâmetro na resolução do Nome do Domínio.

Set-CMFallbackStatusPoint

Alterações não-quebrando

Fixou um nome de parâmetro inconsistente.

Set-CMThirdPartyUpdateCatalog

Alterações não-quebrando

Adicionar parâmetros CategoriaNamePublishOption e CategoryIdPublishOption. Utilize estes parâmetros para definir a opção de publicação da categoria quando subscrever 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 não-quebrando

Corrigi um problema com o parâmetro de PublishOption definido para FullContent .

Set-CMTSStep*

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

Alterações não-quebrando

O Operador de ParâmetroType tem outro valor possível:NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

Alterações interruptivas

Corrigiu um problema para o parâmetro O365LanguageSelection. Agora precisa especificar uma língua com um nome de país. Esta alteração alinha este parâmetro com as opções na consola 'Gestor de Configuração'. Por exemplo, -O365LanguageSelection "English (United States)"

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.