Compartilhar via

Configuration Manager da Biblioteca de Cmdlets do Branch Atual 1610

  • Artigo

Observação

A versão 1604 da biblioteca Configuration Manager cmdlet é a linha de base para essas alterações.

Alterações importantes

O console do administrador permite iniciar o ISE (Ambiente de Script Integrado)

No console do administrador, uma opção adicional foi adicionada para iniciar o ISE: "Conectar por meio Windows PowerShell ISE".

Verificação de atualização do cmdlet

A Biblioteca de Cmdlets não verificará mais se há versões atualizadas. Essa verificação não é mais necessária, pois a Biblioteca de Cmdlets agora é fornecida simultaneamente com Configuration Manager versões.

Os cmdlets Get-CM* podem dar suporte ao modo "Rápido" e podem retornar um aviso se ele não for usado

Alguns cmdlets Get agora têm um parâmetro Fast. Esse parâmetro permite que o cmdlet retorne objetos sem atualizar automaticamente as propriedades lentas. A recuperação de valores de propriedade lentos pode causar tráfego de rede adicional e reduzir a execução do cmdlet. Se as propriedades lentas não forem usadas, o Modo Rápido deverá ser fornecido como um parâmetro de cmdlet.

Para fornecer visibilidade sobre essa alteração, os cmdlets que dão suporte ao Fast gravarão um aviso no console se ele não for usado em um caso em que sua presença possa ser benéfica. Esse aviso pode ser suprimido definindo.$CMPSSuppressFastNotUsedCheck = $True

Como fornecer comentários ou relatar problemas

Muitas das correções e melhorias descritas neste documento são resultado dos comentários dos clientes. Para obter mais informações, consulte Comentários sobre o produto.

Problemas conhecidos

Esses são problemas conhecidos com a Biblioteca de Cmdlets que não são resolvidos nesta versão.

Não é possível importar o módulo ConfigurationManager.psd1 usando o nome lógico

Se o caminho para o módulo ConfigurationManager.psd1 for adicionado à variável de ambiente PSMODULEPATH, ele não poderá ser importado usando Import-Module ConfigurationManager.

Solução alternativa

Add-CMEnrollmentProxyPoint

O cmdlet pode não configurar corretamente o ponto proxy de registro se houver vários pontos de registro para o site primário ou se o ponto de registro estiver em um servidor separado.

Solução alternativa

  • Use o console do administrador para essa configuração.

Get-CMAadConditionalAccessPolicy/Set-CMAadConditionalAccessPolicy

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

Solução alternativa

  • Nenhum

Novos cmdlets

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

Configurações do cliente

Novos cmdlets foram gravados para melhorar a experiência em relação à modificação das configurações do cliente. Esses cmdlets substituem o cmdlet Set-CMClientSetting , que agora foi preterido. Esses cmdlets dão suporte ao uso do pipeline de objeto do cmdlet Get-CMClientSetting para modificar as configurações de cliente definidas pelo usuário.

  • Set-CMClientSettingBackgroundIntelligentTransfer
  • Set-CMClientSettingClientCache
  • Set-CMClientSettingClientPolicy
  • Set-CMClientSettingCloudService
  • Set-CMClientSettingComplianceSetting
  • Set-CMClientSettingComputerAgent
  • Set-CMClientSettingComputerRestart
  • Set-CMClientSettingEndpointProtection
  • Set-CMClientSettingEnrollment
  • Set-CMClientSettingGeneral
  • Set-CMClientSettingHardwareInventory
  • Set-CMClientSettingMeteredInternetConnection
  • Set-CMClientSettingPowerManagement
  • Set-CMClientSettingRemoteTool
  • Set-CMClientSettingSoftwareDeployment
  • Set-CMClientSettingSoftwareInventory
  • Set-CMClientSettingSoftwareMetering
  • Set-CMClientSettingSoftwareUpdate
  • Set-CMClientSettingStateMessaging
  • Set-CMClientSettingUserAndDeviceAffinity

Política de acesso condicional

Novos cmdlets foram gravados para dar suporte às configurações de política de acesso condicional do Azure Active Directory (Azure AD).

  • Get-CMAadConditionalAccessPolicy
  • Set-CMAadConditionalAccessPolicy

Exemplo

PR1:\> Get-CMAadConditionalAccessPolicy -AccountId 752c1e46-ddd2-4ffc-8f15-23623328c823 -ServicePrincipalType ExchangeOnline -UserCredential (Get-Credential)

PR1:\> Set-CMAadConditionalAccessPolicy -AccountId 752c1e46-ddd2-4ffc-8f15-23623328c823 -ServicePrincipalType ExchangeOnline -Enabled $true -TargetedDevicePlatforms Windows,WindowsPhone -WindowsDeviceState Compliant -IncludedSecurityGroup All_Users -UserCredential (Get-Credential)

Copy-CMCollection

Esse cmdlet pode ser usado para clonar uma coleção existente para uma nova.

Proteção de pontos de extremidade

Novos cmdlets para gerenciamento avançado de política de proteção contra ameaças:

  • Get-CMAdvancedThreatProtectionPolicy
  • New-CMAdvancedThreatProtectionPolicy
  • Remove-CMAdvancedThreatProtectionPolicy
  • Set-CMAdvancedThreatProtectionPolicy

Get/Set-CMSiteSummaryTask

Esses cmdlets podem ser usados para obter e definir tarefas de resumo do site.

Invoke-CMPromotePreProductionClient

Esse cmdlet pode ser usado para promover o cliente de pré-produção para o status de produção.

Exemplo

PR1:\> Invoke-CMPromotePreProductionClient -Force

Migração

Novos cmdlets para trabalhos de migração:

  • Get-CMMigrationJob
  • Set-CMMigrationJob

Rename-CMCategory

Esse cmdlet pode ser usado para renomear uma categoria.

Exemplo

PR1:\> Get-CMCategory -Name MyCategoryName | Rename-CMCategory -NewName MyCategoryNewName -CategoryType AppCategories

Alterações de cmdlet

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

Alterações diversas

Bugs que foram corrigidos

Cmdlets de tipo de implantação que exigem um parâmetro url podem não validar o valor do parâmetro para correção (por exemplo, Add-CMGooglePlayDeploymentType, Set-CMWindowsPhoneStoreDeploymentType).

Os cmdlets de tipo de implantação que dão suporte ao MAM (Gerenciamento de Aplicativo Móvel) podem não adicionar esses detalhes ao modelo de aplicativo, fazendo com que a guia "Políticas do Configuração de Aplicativos" esteja ausente no console do administrador.

Os cmdlets<tecnologia add-CM > DeploymentType não criam tipos de implantação usando a mesma convenção de nomenclatura que o console do administrador.

Os cmdlets de tipo de implantação que exigem um arquivo em vez de um caminho de arquivo (por exemplo, Add-CMMsiDeploymentType) agora relatarão uma causa de falha mais clara se um argumento inesperado for especificado para o parâmetro ContentLocation .

Alterações sem interrupção

Os dados do provedor __GENERIC objetos WMI agora exibem mais dados para o Windows PowerShell console.

"Conectar por meio Windows PowerShell ISE" do console do administrador

Bugs que foram corrigidos

O script gerado não foi executado devido a um caminho inválido para o módulo ConfigurationManager. Se um script inválido já tiver sido gerado, remova o arquivo %TEMP%\ISEConnect_sitecode - sitename.ps1 existente e reiniciar o ISE do console do administrador.

O script gerado pode ficar ilegível quando um pacote de idiomas do console do administrador é instalado. Se um script inválido já tiver sido gerado, remova o arquivo %TEMP%\ISEConnect_sitecode – sitename.ps1 e reiniciar o ISE do console do administrador.

Um erro de caminho inválido pode ser gerado ao iniciar o ISE no console do administrador.

Add-CMDeploymentType

Bugs que foram corrigidos

O cmdlet pode retornar um aviso de "Versão inesperada do site".

Add-CMDeviceCollectionQueryMembershipRule

Bugs que foram corrigidos

O cmdlet não verifica a validade da consulta especificada pelo parâmetro QueryExpression . Não é possível criar regras de consulta com nomes duplicados (não se alinha com o comportamento do console do administrador).

Add-CMDriverToDriverPackage

Bugs que foram corrigidos

O objeto pipelined pode ser descartado pelo cmdlet.

Add-CMEndpointProtectionPoint

Bugs que foram corrigidos

Adicionar um ponto de proteção de ponto de extremidade pela primeira vez a um site pode resultar em uma configuração de cliente padrão incorreta.

Add-CMIntuneSubscription

Bugs que foram corrigidos

O parâmetro ContactEmail não executa a validação para correção.

Add-CMMsiDeploymentType

Bugs que foram corrigidos

O valor do parâmetro EnableBranchCache é ignorado.

Alterações sem interrupção

Adicionado o parâmetro InstallationBehaviorType .

Add-CMScriptDeploymentType

Bugs que foram corrigidos

O valor do parâmetro EnableBranchCache é ignorado.

Alterações sem interrupção

Adicionado o parâmetro InstallationBehaviorType .

Add-CMUserCollectionQueryMembershipRule

Bugs que foram corrigidos

O cmdlet não verifica a validade da consulta especificada pelo parâmetro QueryExpression .

Não é possível criar regras de consulta com nomes duplicados (não se alinha com o comportamento do console do administrador).

Block-CMDevice

Alterações sem interrupção

O cmdlet agora aceita o objeto pipelined de Get-CMDevice.

Export-CMUserCollection

Alterações interruptivas

O cmdlet agora requer que o argumento ExportFilePath termine em uma extensão de arquivo .mof.

Get-CMCategory

Alterações sem interrupção

Validação aprimorada do parâmetro CategoryType .

Get-CMClientSetting

Bugs que foram corrigidos

O parâmetro SettingType pode ser ignorado.

Get-CMDeploymentTypeDependency

Bugs que foram corrigidos

Dependências inesperadas podem ser retornadas pelo cmdlet.

Get-CMDeviceAction

Bugs que foram corrigidos

Não é possível exibir a nova senha para uma ação PinReset.

Get-CMResource

Bugs que foram corrigidos

O parâmetro rápido está ausente.

Get-CMSiteRole

Alterações interruptivas

Quando conectado a um site primário e nenhum parâmetro SiteCode for especificado, somente as funções específicas do site conectado serão retornadas. Essa alteração foi feita para ter paridade e consistência com o console do administrador. Por exemplo, se você tiver um CAS e estiver executando o cmdlet em um site primário, somente as funções de site para o código do site atual serão usadas. As funções de site para todos os sites serão retornadas durante a execução de um CAS.

Para restaurar o comportamento anterior, o parâmetro AllSites pode ser usado para consultar todos os sites dentro da hierarquia de qualquer site conectado.

Get-CMSoftwareUpdate

Bugs que foram corrigidos

O valor do parâmetro UpdateGroup pode ser descartado pelo cmdlet.

Import-CMAntimalwarePolicy

Bugs que foram corrigidos

As políticas exportadas de versões anteriores Configuration Manager podem falhar ao importar corretamente.

Import-CMAntimalwarePolicy

Bugs que foram corrigidos

A política pode não importar ou pode ser criada com erros de validação.

O cmdlet permite importar um arquivo que já foi importado.

Import-CMComputerInformation

Alterações interruptivas

O parâmetro CollectionName agora é obrigatório.

Alterações sem interrupção

Adicionado suporte para importação de computadores pelo nome de domínio totalmente qualificado.

Import-CMDriver

Alterações interruptivas

Se ocorrer uma importação parcial de driver, o cmdlet não falhará mais. Em vez disso, ele avisará que alguns drivers não foram importados com êxito. Em um evento em que nenhum driver pode ser importado, o cmdlet ainda falhará.

Import-CMDriverPackage

Alterações sem interrupção

Novo parâmetro ImportActionType para controlar o comportamento quando um pacote já existir.

Import-CMPackage

Alterações sem interrupção

Novo parâmetro ImportActionType para controlar o comportamento quando um pacote já existir.

Import-CMSecurityRole

Bugs que foram corrigidos

O cmdlet permite que valores de parâmetro NewRoleName inválidos sejam usados.

Import-CMTaskSequence

Alterações sem interrupção

Novo parâmetro ImportActionType para controlar o comportamento quando um pacote já existir.

Invoke-CMDeviceAction

Bugs que foram corrigidos

O cmdlet poderá falhar com uma exceção se determinadas informações de descoberta não estão disponíveis para o dispositivo de destino.

Invoke-CMDeviceRetire

Bugs que foram corrigidos

O cmdlet falha silenciosamente quando o usuário não tem permissão para invocar a operação de desativação.

O cmdlet não falha com uma mensagem de erro clara ao tentar desativar um dispositivo sem suporte.

O cmdlet não falha com uma mensagem de erro clara ao tentar desativar um dispositivo apagado.

Alterações sem interrupção

Novo parâmetro Cancel para cancelar uma desativação de dispositivo pendente.

Invoke-CMDeviceWipe

Bugs que foram corrigidos

O cmdlet falha silenciosamente quando o usuário não tem permissão para invocar a operação de apagamento.

O cmdlet não falha com uma mensagem de erro clara ao tentar apagar um dispositivo sem suporte.

Talvez não seja possível apagar Intune gerenciado pelo usuário.

Alterações sem interrupção

Novo parâmetro Cancel para cancelar um apagamento de dispositivo pendente.

Invoke-CMSoftwareUpdateAutoDeploymentRule

Bugs que foram corrigidos

O objeto pipelined pode ser descartado pelo cmdlet.

Move-CMObject

Bugs que foram corrigidos

O cmdlet não consegue localizar um objeto a ser movido.

New-CMBootableMedia

Bugs que foram corrigidos

O cmdlet não valida corretamente os valores de parâmetro CertificateExpireTime e CertificateStartTime .

New-CMCaptureMedia

Alterações interruptivas

Foram removidos os parâmetros PrestartCommand e PrestartPackage desnecessários.

New-CMCategory

Bugs que foram corrigidos

O cmdlet permite a criação de tipo de categoria GlobalCondition sem suporte.

Alterações sem interrupção

Validação aprimorada do parâmetro CategoryType .

New-CMClientSetting

Alterações interruptivas

O parâmetro SettingType agora é obrigatório.

New-CMComputerAssociation

Alterações sem interrupção

Melhorias de desempenho.

New-CMDeviceVariable

Bugs que foram corrigidos

Não é possível criar variáveis de dispositivo para um membro do site primário do CAS.

O objeto de coleção pipelined pode ser descartado pelo cmdlet.

New-CMGlobalCondition

Bugs que foram corrigidos

O comprimento do valor do parâmetro InstanceName não é validado.

Alterações sem interrupção

Adicionada a capacidade de criar tipos de dados de configuração base64 e xml.

New-CMPowerManagementCustomPlan

Bugs que foram corrigidos

Os parâmetros DisplayOffMinAC e DisplayOffMinDC não estão configurados no plano resultante.

New-CMPrestageMedia

Alterações sem interrupção

Adicionados os parâmetros MediaPassword, TaskSequence e IncludeApplicationDependency.

New-CMQuery

Bugs que foram corrigidos

O cmdlet não valida se o nome da consulta já existe.

New-CMTaskSequence

Bugs que foram corrigidos

A reversão não é configurada quando o parâmetro UpgradeOperatingSystem é usado.

Atualizações e as etapas do aplicativo não são colocadas nas posições esperadas quando o parâmetro UpgradeOperatingSystem é usado.

New-CMWindowsEnrollmentProfile

Bugs que foram corrigidos

O perfil de registro pode não conter configuração de intranet válida.

Remove-CMAdministrativeUser

Alterações interruptivas

Removido o parâmetro RoleName não funcional.

Remove-CMContentDistribution

Bugs que foram corrigidos

O objeto pipelined pode ser descartado pelo cmdlet.

Remove-CMDeviceVariable

Bugs que foram corrigidos

O cmdlet falhará silenciosamente se tentar remover uma variável que não existe.

Não é possível remover variáveis de dispositivo para um membro do site primário do CAS.

O cmdlet pode rejeitar um objeto membro da coleção em pipeline válido.

Remove-CMIntuneSubscription

Bugs que foram corrigidos

O cmdlet poderá falhar silenciosamente ou com uma mensagem de erro incerta se uma assinatura Microsoft Intune não existir.

Remove-CMMaintenanceWindow

Bugs que foram corrigidos

O cmdlet pode ignorar o parâmetro Name e remover janelas de manutenção adicionais.

Alterações sem interrupção

O cmdlet dá suporte à dica de parâmetro DisableWildcardHandling para o parâmetro Name.

Remove-CMMulticastServicePoint

Bugs que foram corrigidos

Especificar o parâmetro RemoveWDS com um valor falso ainda pode fazer com que o recurso WDS seja removido.

Set-CMAppVVirtualEnvironment

Bugs que foram corrigidos

O parâmetro AddApplicationGroup não verifica se o grupo já foi adicionado.

Set-CMBaselineDeployment

Bugs que foram corrigidos

O cmdlet poderá ignorar silenciosamente OverrideServiceWindow se a imposição não estiver habilitada para a implantação.

Set-CMBoundaryGroup

Bugs que foram corrigidos

O parâmetro DefaultSiteCode não permite valor nulo para limpar a configuração.

Set-CMClientSetting

Preterições

O cmdlet foi preterido e substituído por um cmdlet específico do recurso. Consulte Novos cmdlets para obter mais detalhes.

Set-CMCollectionMembershipEvaluationComponent

Preterições

O parâmetro SiteSystemServerName foi preterido.

Set-CMCollectionPowerManagement

Bugs que foram corrigidos

Não é possível alterar uma política de gerenciamento de energia de NeverApply para Aplicar.

Set-CMConditionalAccessPolicy

Bugs que foram corrigidos

O cmdlet pode não modificar coleções excluídas ao especificar uma política usando os parâmetros Name ou Id .

Set-CMDeploymentType

Bugs que foram corrigidos

O cmdlet pode retornar um aviso de "Versão inesperada do site".

Set-CMDeviceVariable

Bugs que foram corrigidos

O cmdlet falhará silenciosamente se tentar definir uma variável que não existe.

Não é possível configurar variáveis de dispositivo para um membro do site primário do CAS.

O cmdlet pode rejeitar um objeto membro da coleção em pipeline válido.

Alterações sem interrupção

Novo parâmetro PassThru para retornar a variável de dispositivo resultante.

Set-CMDistributionPoint

Bugs que foram corrigidos

O cmdlet pode retornar avisos inesperados sobre a configuração do ponto de serviço multicast.

Set-CMFileReplicationRoute

Bugs que foram corrigidos

Não é possível definir FileReplicationAccountName sem especificar um modo de replicação.

Set-CMGlobalCondition

Bugs que foram corrigidos

O comprimento do valor do parâmetro InstanceName não é validado.

Set-CMIntuneSubscription

Bugs que foram corrigidos

O parâmetro ContactEmail não executa a validação para correção.

Set-CMIntuneSubscriptionAppleMdmProperty

Bugs que foram corrigidos

O cmdlet pode não avisar quando determinadas dependências de parâmetro necessárias não forem atendidas.

Set-CMIntuneSubscriptionPassportForWorkProperty

Bugs que foram corrigidos

O valor do parâmetro EnableBiometrics pode ser ignorado.

Set-CMIntuneSubscriptionWindowsPhoneProperty

Bugs que foram corrigidos

O cmdlet pode não falhar quando determinadas combinações de parâmetro inválidas são usadas.

Set-CMMigrationJob

Bugs que foram corrigidos

Especificar o parâmetro UtcTime sem o parâmetro MigrationJobSchedule pode resultar em uma configuração de trabalho de migração inválida.

Set-CMMigrationSource

Bugs que foram corrigidos

O cmdlet falhará silenciosamente se tentar criar uma fonte de migração com um nome que já existe.

Alterações sem interrupção

O cmdlet tentará expandir o valor do parâmetro SourceSiteServerName se um nome de domínio totalmente qualificado não for usado.

Set-CMMsiDeploymentType

Alterações sem interrupção

Adicionado o parâmetro InstallationBehaviorType .

Set-CMScriptDeploymentType

Alterações sem interrupção

Adicionado o parâmetro InstallationBehaviorType .

Set-CMSite

Bugs que foram corrigidos

O cmdlet poderá falhar se o parâmetro SiteCode for usado.

Alterações sem interrupção

Foram removidos conjuntos de parâmetros extras não utilizados (SetSecurityScopeByName, SetSecurityScopeBySiteCode e SetSecurityScopeByValue).

Set-CMSiteMaintenanceTask

Alterações interruptivas

O parâmetro SiteCode foi removido.

Preterições

O parâmetro SummaryTask foi preterido. TaskName deve ser usado em vez disso.

Alterações sem interrupção

Aceita a entrada em pipeline de Get-CMSiteMaintenanceTask.

Várias melhorias de usabilidade.

Adicionado o parâmetro TaskName para definir uma tarefa pelo nome.

Set-CMSoftwareUpdateDeployment

Alterações sem interrupção

Aprimorada a saída ao usar Confirm ou WhatIf.

Set-CMSoftwareUpdatePointComponent

Bugs que foram corrigidos

Não é possível especificar "Publicador Local" como um valor para o parâmetro AddCompany .

Set-CMSoftwareUpdateSummarizationSchedule

Alterações sem interrupção

Aprimorada a saída ao usar Confirm ou WhatIf.

Start-CMBaselineDeployment

Bugs que foram corrigidos

O cmdlet poderá ignorar silenciosamente OverrideServiceWindow se a imposição não estiver habilitada para a implantação.

Start-CMContentDistribution

Bugs que foram corrigidos

O objeto pipelined pode ser descartado pelo cmdlet.

Start-CMTaskSequenceDeployment

Bugs que foram corrigidos

A implantação poderá não ser criada corretamente se o parâmetro DeploymentOption não for especificado.

O cmdlet pode retornar um aviso de que os parâmetros PercentSuccess ou PercentFailure são ignorados quando não são especificados.

Alterações sem interrupção

Se DeploymentOption não for especificado, um valor de DownloadContentLocallyWhenNeededByRunningTaskSequence será implícito.

Unblock-CMDevice

Alterações sem interrupção

O cmdlet agora aceita o objeto pipelined de Get-CMDevice.

Unlock-CMObject

Alterações sem interrupção

Agora, o cmdlet falhará se tentar desbloquear um objeto bloqueado por uma sessão diferente do Provedor de SMS. Em versões anteriores, isso falharia silenciosamente.

Adicionado o parâmetro Force para tentar desbloquear objetos que podem ser bloqueados por uma sessão diferente do Provedor de SMS. Isso pode ser usado para se recuperar de um cenário em que um objeto foi bloqueado por um console de administrador que foi encerrado inesperadamente sem liberar o bloqueio de objeto.