Partilhar via

Alterações na Biblioteca Cmdlet do Gestor de Configuração para o Ramo Atual 1610

  • Artigo

Nota

A versão 1604 da Biblioteca Cmdlet Do Gestor de Configuração é a linha de base para estas alterações.

Mudanças importantes

Consola de administrador permite lançar o Ambiente Integrado de Scripting (ISE)

A partir da consola de administrador, foi adicionada uma opção adicional para o lançamento do ISE: "Connect via Windows PowerShell ISE".

Verificação de atualização de cmdlet

A Biblioteca Cmdlet deixará de verificar se existem versões atualizadas. Esta verificação já não é necessária, uma vez que a Biblioteca Cmdlet agora envia simultaneamente com lançamentos do Gestor de Configuração.

Os cmdlets Get-CM* podem suportar o modo "Fast" e podem retornar um aviso se não for utilizado

Alguns get cmdlets agora têm um parâmetro rápido. Este parâmetro permite que o cmdlet devolva os objetos sem refrescar automaticamente as propriedades preguiçosas. Recuperar valores de propriedade preguiçosos pode causar tráfego adicional de rede e pode retardar a execução do cmdlet. Se não forem utilizadas propriedades preguiçosas, o Fast deve ser fornecido como parâmetro cmdlet.

Para dar visibilidade a esta mudança, os cmdlets que suportam o Fast escreverão um aviso à consola se não for utilizado num caso em que a sua presença possa ser benéfica. Este aviso pode ser suprimido por definição $CMPSSuppressFastNotUsedCheck = $True .

Como fornecer problemas de feedback ou relatório

Muitas das correções e melhorias descritas neste documento são resultado do feedback do cliente. Para mais informações, consulte o feedback do Produto.

Problemas conhecidos

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

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

Se o caminho para o módulo ConfigurationManager.psd1 for adicionado à variável ambiente PSMODULEPATH, não pode ser importado utilizando Import-Module ConfiguraçãoManager.

Solução

Add-CMEnrollmentProxyPoint

O Cmdlet pode não configurar adequadamente o ponto de procuração de inscrição se existirem vários pontos de inscrição para o site primário, ou se o ponto de inscrição estiver num servidor separado.

Solução

  • Utilize a consola de administrador para esta configuração.

Get-CMAadConditionalAccessPolicy/Set-CMAadConditionalAccessPolicy

Para estes cmdlets é necessário um ambiente powershell de 64 bits.

Solução

  • Nenhum

Novos cmdlets

Estes são novos cmdlets adicionados para esta versão que adicionam uma nova funcionalidade ou melhoram a funcionalidade dos cmdlets existentes.

Definições do cliente

Foram escritos novos cmdlets para melhorar a experiência em torno da modificação das configurações do cliente. Estes cmdlets substituem o cmdlet set-CMClientSetting, que agora é depreciado. Estes cmdlets suportam a utilização do pipeline de objetos a partir do cmdlet Get-CMClientSetting para modificar as definições do cliente definidas pelo utilizador.

  • 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

Foram escritos novos cmdlets para apoiar as definições de política de acesso condicional do Azure Ative 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

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

Proteção de ponto final

Novos cmdlets para a gestão avançada da política de proteção de ameaças:

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

Obter/Set-CMSiteSummaryTask

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

Invoke-CMPromotePreProductionClient

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

Exemplo

PR1:\> Invoke-CMPromotePreProductionClient -Force

Migração

Novos comandantes para empregos migratórios:

  • Get-CMMigrationJob
  • Set-CMMigrationJob

Rename-CMCategory

Este cmdlet pode ser usado para mudar o nome de uma categoria.

Exemplo

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

Alterações do Cmdlet

Foram efetuadas as seguintes alterações aos cmdlets existentes para esta libertação. As alterações podem ser novas funcionalidades, correções de bugs ou depreciações, e podem estar a quebrar. Se utilizar um dos cmdlets ou áreas de funcionalidade listadas nesta secção, por favor reveja cuidadosamente as alterações para entender como podem afetar a sua utilização.

Alterações diversas

Insetos que foram corrigidos

Os cmdlets do tipo de implementação que requerem um parâmetro url podem não validar o valor do parâmetro para a correção (por exemplo, Add-CMGooglePlayDeploymentType, Set-CMWindowsPhoneStoreDeploymentType).

Os cmdlets do tipo de implementação que suportam a Gestão de Aplicações Móveis (MAM) não podem adicionar estes detalhes ao modelo de aplicação, fazendo com que o separador "Políticas de Configuração de Aplicações" esteja em falta na consola do administrador.

A tecnologia dede implementação não cria tipos de implementação utilizando a mesma convenção de nomeação que a consola de administrador.

Os cmdlets do tipo de implementação que requerem um ficheiro em vez de uma trajetória de ficheiro (por exemplo, Add-CMMsiDeploymentType) irão agora reportar uma causa de falha mais clara se for especificado um argumento inesperado para o parâmetro DeLocalização de Conteúdos.

Alterações não-quebrando

Os dados do fornecedor que representam _ _GENERIC objetos WMI exibem agora mais dados para a consola Windows PowerShell.

"Connect via Windows PowerShell ISE" da consola de administrador

Insetos que foram corrigidos

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

O script gerado pode ser ilegível quando um pacote de linguagem de consola de administrador é instalado. Se já tiver sido gerado um script inválido, remova o %TEMP%\ISEConnect_sitecode existente - sitename.ps1 ficheiro e relançe ISE da consola do administrador.

Um erro de trajetória inválido pode ser levantado ao lançar o ISE a partir da consola do administrador.

Add-CMDeploymentType

Insetos que foram corrigidos

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

Add-CMDeviceCollectionQueryMembershipRule

Insetos 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 da consola do administrador).

Add-CMDriverToDriverPackage

Insetos que foram corrigidos

O objeto em pipeline pode ser eliminado pelo cmdlet.

Add-CMEndpointProtectionPoint

Insetos que foram corrigidos

Adicionar um ponto de proteção de ponto final pela primeira vez a um site pode resultar numa configuração de configurações de configurações de clientes predefinidos incorretas.

Add-CMIntuneSubscription

Insetos que foram corrigidos

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

Add-CMMsiDeploymentType

Insetos que foram corrigidos

O valor do parâmetro EnableBranchCache é ignorado.

Alterações não-quebrando

Instalação AdicionadaOpostype.

Add-CMScriptDeploymentType

Insetos que foram corrigidos

O valor do parâmetro EnableBranchCache é ignorado.

Alterações não-quebrando

Instalação AdicionadaOpostype.

Add-CMUserCollectionQueryMembershipRule

Insetos 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 da consola do administrador).

Block-CMDevice

Alterações não-quebrando

A Cmdlet aceita agora objeto em pipelineed da Get-CMDevice.

Export-CMUserCollection

Alterações interruptivas

O Cmdlet exige agora que o argumento ExportFilePath termine numa extensão de ficheiro .mof.

Get-CMCategory

Alterações não-quebrando

Melhor validação do parâmetro CategoryType.

Get-CMClientSetting

Insetos que foram corrigidos

O parâmetro de definição deTipo pode ser ignorado.

Get-CMDeploymentTypeDependency

Insetos que foram corrigidos

Dependências inesperadas podem ser devolvidas pelo cmdlet.

Get-CMDeviceAction

Insetos que foram corrigidos

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

Get-CMResource

Insetos que foram corrigidos

Falta um parâmetro rápido.

Get-CMSiteRole

Alterações interruptivas

Quando ligado a um site primário e não for especificado nenhum parâmetro Do SiteCode, apenas serão devolvidas funções específicas do site conectado. Esta alteração foi feita para ter paridade e consistência com a consola do administrador. Por exemplo, se tiver um CAS e estiver a executar o cmdlet num site primário, apenas serão utilizadas funções do site para o código do site atual. As funções do site para todos os sites serão devolvidas quando correrem de um CAS.

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

Get-CMSoftwareUpdate

Insetos que foram corrigidos

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

Import-CMAntimalwarePolicy

Insetos que foram corrigidos

As políticas exportadas a partir de versões anteriores do Gestor de Configuração podem não conseguir importar adequadamente.

Import-CMAntimalwarePolicy

Insetos que foram corrigidos

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

O Cmdlet permite-lhe importar um ficheiro que já foi importado.

Import-CMComputerInformation

Alterações interruptivas

O parâmetro CollectionName é agora obrigatório.

Alterações não-quebrando

Suporte adicional para a importação de computadores pelo seu nome de domínio totalmente qualificado.

Import-CMDriver

Alterações interruptivas

Se ocorrer uma importação parcial do condutor, o cmdlet deixará de falhar. Em vez disso, advertirá que alguns condutores não foram importados com êxito. Num caso em que nenhum condutor possa ser importado, o cmdlet continuará a falhar.

Import-CMDriverPackage

Alterações não-quebrando

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

Import-CMPackage

Alterações não-quebrando

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

Import-CMSecurityRole

Insetos que foram corrigidos

O Cmdlet permite a utilização de valores de parâmetros newrolename inválidos.

Import-CMTaskSequence

Alterações não-quebrando

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

Invoke-CMDeviceAction

Insetos que foram corrigidos

O Cmdlet pode falhar com uma exceção se certas informações de descoberta não estiverem disponíveis para o dispositivo direcionado.

Invoke-CMDeviceRetire

Insetos que foram corrigidos

O Comandante falha silenciosamente quando o utilizador não tem autorização para invocar a operação de aposentação.

O Comandante não falha com uma mensagem de erro clara ao tentar retirar um dispositivo não suportado.

O Comandante não falha com uma mensagem de erro clara ao tentar retirar um dispositivo limpo.

Alterações não-quebrando

Novo parâmetro cancelar para cancelar a reforma do dispositivo pendente.

Invoke-CMDeviceWipe

Insetos que foram corrigidos

O Comandante falha silenciosamente quando o utilizador não tem permissão para invocar a operação de limpeza.

O Comandante não falha com uma mensagem de erro clara ao tentar limpar um dispositivo não suportado.

Pode não ser capaz de limpar o dispositivo gerido pela Intune.

Alterações não-quebrando

Novo parâmetro cancelar para cancelar uma limpeza do dispositivo pendente.

Invoke-CMSoftwareUpdateAutoDeploymentRule

Insetos que foram corrigidos

O objeto em pipeline pode ser eliminado pelo cmdlet.

Move-CMObject

Insetos que foram corrigidos

O Comandante não encontra um objeto para se mover.

New-CMBootableMedia

Insetos que foram corrigidos

A Cmdlet não valida adequadamente os valores dos parâmetros CertificateExpireTime e CertificateStartTime.

New-CMCaptureMedia

Alterações interruptivas

Removidos os parâmetros PrestarCommand e PrestartPackage.

New-CMCategory

Insetos que foram corrigidos

A Cmdlet permite a criação de um tipo de categoria GlobalCondition não suportada.

Alterações não-quebrando

Melhor validação do parâmetro CategoryType.

New-CMClientSetting

Alterações interruptivas

O parâmetro de definição de Tipo é agora obrigatório.

New-CMComputerAssociation

Alterações não-quebrando

Melhorias de desempenho.

New-CMDeviceVariable

Insetos que foram corrigidos

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

O objeto de recolha em pipeline pode ser eliminado pelo cmdlet.

New-CMGlobalCondition

Insetos que foram corrigidos

Exemplo O comprimento do valor do parâmetro do nome de instância não é validado.

Alterações não-quebrando

Adicionou a capacidade de criar tipos de dados de base64 e xml.

New-CMPowerManagementCustomPlan

Insetos que foram corrigidos

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

New-CMPrestageMedia

Alterações não-quebrando

Adicionados MediaPassword, TaskSequence e Incluir Os parâmetros de Dependência da Aplicação.

New-CMQuery

Insetos que foram corrigidos

A Cmdlet não valida se o nome de consulta já existe.

New-CMTaskSequence

Insetos que foram corrigidos

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

As atualizações e as etapas de aplicação não são colocadas nas posições esperadas quando o parâmetro UpgradeOperatingSystem é utilizado.

New-CMWindowsEnrollmentProfile

Insetos que foram corrigidos

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

Remove-CMAdministrativeUser

Alterações interruptivas

Removido o parâmetro rolename não funcional.

Remove-CMContentDistribution

Insetos que foram corrigidos

O objeto em pipeline pode ser eliminado pelo cmdlet.

Remove-CMDeviceVariable

Insetos que foram corrigidos

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

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

A Cmdlet pode rejeitar um objeto de membro de recolha em pipeline válido.

Remove-CMIntuneSubscription

Insetos que foram corrigidos

O Cmdlet pode falhar silenciosamente ou com uma mensagem de erro pouco clara se não existir uma subscrição do Microsoft Intune.

Remove-CMMaintenanceWindow

Insetos que foram corrigidos

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

Alterações não-quebrando

Cmdlet suporta sugestão de parâmetros DisableWildcardHandling para o parâmetro Nome.

Remove-CMMulticastServicePoint

Insetos que foram corrigidos

Especificar o parâmetro RemoveWDS com um valor de falso pode ainda fazer com que a função WDS seja removida.

Set-CMAppVVirtualEnvironment

Insetos que foram corrigidos

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

Set-CMBaselineDeployment

Insetos que foram corrigidos

A Cmdlet pode ignorar silenciosamente o OverrideServiceWindow se a execução não estiver ativada para a implementação.

Set-CMBoundaryGroup

Insetos que foram corrigidos

Padrão O parâmetro Deseritosoooose não permite o valor nulo para a compensação da definição.

Set-CMClientSetting

Depreciação

O Comandante foi depreciado e substituído por um cmdlet específico de recurso. Consulte novos Comandantes para mais detalhes.

Set-CMCollectionMembershipEvaluationComponent

Depreciação

O parâmetro SiteSystemServerName foi depreciado.

Set-CMCollectionPowerManagement

Insetos que foram corrigidos

Não é possível alterar uma política de gestão de energia do NeverApply para aplicar.

Set-CMConditionalAccessPolicy

Insetos que foram corrigidos

O Cmdlet pode não conseguir modificar as coleções excluídas ao especificar uma política utilizando os parâmetros Nome ou ID.

Set-CMDeploymentType

Insetos que foram corrigidos

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

Set-CMDeviceVariable

Insetos que foram corrigidos

O Comandante 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 local primário do CAS.

A Cmdlet pode rejeitar um objeto de membro de recolha em pipeline válido.

Alterações não-quebrando

Novo parâmetro PassThru para devolver a variável do dispositivo resultante.

Set-CMDistributionPoint

Insetos que foram corrigidos

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

Set-CMFileReplicationRoute

Insetos que foram corrigidos

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

Set-CMGlobalCondition

Insetos que foram corrigidos

Exemplo O comprimento do valor do parâmetro do nome de instância não é validado.

Set-CMIntuneSubscription

Insetos que foram corrigidos

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

Set-CMIntuneSubscriptionAppleMdmProperty

Insetos que foram corrigidos

O Comandante não pode avisar quando determinadas dependências de parâmetros necessários não forem satisfeitas.

Set-CMIntuneSubscriptionPassportForWorkProperty

Insetos que foram corrigidos

O valor do parâmetro EnableBiometrics pode ser ignorado.

Set-CMIntuneSubscriptionWindowsPhoneProperty

Insetos que foram corrigidos

O Cmdlet pode não falhar quando forem utilizadas determinadas combinações de parâmetros inválidos.

Set-CMMigrationJob

Insetos que foram corrigidos

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

Set-CMMigrationSource

Insetos que foram corrigidos

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

Alterações não-quebrando

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

Set-CMMsiDeploymentType

Alterações não-quebrando

Instalação AdicionadaOpostype.

Set-CMScriptDeploymentType

Alterações não-quebrando

Instalação AdicionadaOpostype.

Set-CMSite

Insetos que foram corrigidos

O Cmdlet pode falhar se o parâmetro Do SiteCode for utilizado.

Alterações não-quebrando

Conjuntos de parâmetros extra removidos não -, (SetSecurityScopeByName, SetSecurityScopeBySiteCode e SetSecurityScopeByValue).

Set-CMSiteMaintenanceTask

Alterações interruptivas

O parâmetro SiteCode foi removido.

Depreciação

O parâmetro Resumotask foi depreciado. TaskName deve ser usado em vez disso.

Alterações não-quebrando

Aceita a entrada em pipelined da Get-CMSiteMaintenanceTask.

Várias melhorias de usabilidade.

Parâmetro de Nome de Tarefa adicionado para definir uma tarefa pelo seu nome.

Set-CMSoftwareUpdateDeployment

Alterações não-quebrando

Melhorou a saída ao utilizar o Confirm ou o WhatIf.

Set-CMSoftwareUpdatePointComponent

Insetos que foram corrigidos

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

Set-CMSoftwareUpdateSummarizationSchedule

Alterações não-quebrando

Melhorou a saída ao utilizar o Confirm ou o WhatIf.

Start-CMBaselineDeployment

Insetos que foram corrigidos

A Cmdlet poderá ignorar silenciosamente o OverrideServiceWindow se a execução não estiver ativada para a implementação.

Start-CMContentDistribution

Insetos que foram corrigidos

O objeto em pipeline pode ser eliminado pelo cmdlet.

Start-CMTaskSequenceDeployment

Insetos que foram corrigidos

A implementação pode não ser corretamente criada se o parâmetro de Opção de Implementação não for especificado.

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

Alterações não-quebrando

Se a Opção de Implementação não for especificada, está implícito um valor de DownloadContentLocallyWhenNeedEdByRunningTaskSequence.

Unblock-CMDevice

Alterações não-quebrando

A Cmdlet aceita agora objeto em pipelineed da Get-CMDevice.

Unlock-CMObject

Alterações não-quebrando

O Cmdlet falhará agora se tentar desbloquear um objeto que esteja bloqueado por uma sessão diferente do Fornecedor de SMS. Em lançamentos anteriores, isto falharia silenciosamente.

Parâmetro de força adicionado para tentar desbloquear objetos que podem ser bloqueados por uma sessão de Fornecedor de SMS diferente. Isto pode ser usado para recuperar de um cenário em que um objeto foi bloqueado por uma consola de administrador que inesperadamente desistiu sem soltar o bloqueio do objeto.