Compartilhar via

Alterações na Biblioteca de Cmdlets do Configuration Manager para o Current Branch 1702

  • Artigo

Observação

O System Center Configuration Current Branch 1610 é a linha de base para estas alterações. Veja Alterações à Biblioteca de Cmdlets do Configuration Manager para o Current Branch 1610 para obter mais detalhes.

Alterações importantes

Atualizações da biblioteca de documentação

Para obter a documentação mais recente da biblioteca de cmdlets, veja ConfigurationManager module reference (Referência do módulo ConfigurationManager).

Cmdlets removidos

Os seguintes cmdlets já não são suportados e foram removidos:

  • Add-CMNokiaDeploymentType

  • Add-CMOutOfBandServicePoint

  • Add-CMSystemHealthValidatorPoint

  • Clear-CMAmtAuditLog

  • Disable-CMAmtAuditLog

  • Enable-CMAmtAuditLog

  • Enable-CMAutomaticAmtProvisioning

  • Get-CMAutomaticAmtProvisioningStatus

  • Get-CMCmdletUpdateCheck

  • Get-CMOutOfBandManagementComponent

  • Get-CMOutOfBandServicePoint

  • Get-CMSystemHealthValidatorPoint

  • Get-CMSystemHealthValidatorPointComponent

  • New-CMWiredProfileObject

  • New-CMWirelessProfileObject

  • Remove-CMAmtProvisioningData

  • Remove-CMNokiaDeploymentType

  • Remove-CMOutOfBandServicePoint

  • Remove-CMSystemHealthValidatorPoint

  • Send-CMCmdletUpdateCheck

  • Set-CMCmdletUpdateCheck

  • Set-CMNokiaDeploymentType

  • Set-CMOutOfBandManagementComponent

  • Set-CMOutOfBandServicePoint

  • Set-CMSystemHealthValidatorPointComponent

  • Update-CMAmtProvisioning

Suporte para importar o módulo ConfigurationManager com o nome lógico

Agora, existe suporte para importar o módulo ConfigurationManager com um nome lógico ou caminho.

Se o caminho C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin ou equivalente for adicionado à variável PSModulePath , pode utilizar o seguinte:

Import-Module ConfigrationManager

Caso contrário, pode utilizar o seguinte:

Import-Module 'C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin\ConfigurationManager'

Problemas conhecidos

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

Get-CMAadConditionalAccessPolicy e Set-CMAadConditionalAccessPolicy

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

Solução alternativa

  • Nenhum

Novos cmdlets

Estes são cmdlets adicionados recentemente para esta versão que adicionam novas funcionalidades ou melhoram a funcionalidade dos cmdlets existentes.

Perfil de inscrição do iOS

Foram adicionados novos cmdlets para configurar perfis de inscrição iOS.

  • Get-CMIosEnrollmentProfile

  • New-CMIosEnrollmentProfile

  • Remove-CMIosEnrollmentPRofile

  • Set-CMIosEnrollmentProfile

Cmdlets do gateway de gestão da cloud

Foram adicionados novos cmdlets para configurar funções de site do gateway de gestão da cloud.

  • Add-CMCloudManagementGatewayConnectionPoint

  • Get-CMCloudManagementGateway

  • Get-CMCloudManagementGatewayConnectionPoint

  • New-CMCloudManagementGateway

  • Remove-CMCloudManagementGateway

  • Remove-CMCloudManagementGatewayConnectionPoint

  • Set-CMCloudManagementGateway

  • Set-CMCloudManagementGatewayConnectionPoint

  • Start-CMCloudManagementGateway

  • Stop-CMCloudManagementGateway

Cmdlets do Ponto de Serviço do Armazém de Dados

Foram adicionados novos cmdlets para configurar funções de site de ponto de serviço do Armazém de Dados.

  • Add-CMDataWarehouseServicePoint

  • Get-CMDataWarehouseServicePoint

  • Remove-CMDataWarehouseServicePoint

  • Set-CMDataWarehouseServicePoint

Cmdlets de implementação

Foram escritos vários novos cmdlets e foram feitas melhorias em torno dos cenários de monitorização de implementação e implementação.

Estado da distribuição de conteúdos

Get-CMDistributionStatus é um novo cmdlet que pode ser utilizado para obter o estado de distribuição de qualquer objeto de conteúdo, como aplicações, definições ou pacotes de programas.

Obter implementações

Foram criados cmdlets para obter o objeto associado a uma implementação real.

  • Get-CMApplicationDeployment

  • Get-CMBaselineDeployment

  • Get-CMConfigurationPolicyDeployment

  • Get-CMPackageDeployment

  • Get-CMSoftwareUpdateDeployment

  • Get-CMTaskSequenceDeployment

Criação da implementação

Foram criados cmdlets para criar novas implementações. Estes cmdlets substituem os cmdlets start-CM*Deployment pré-existentes.

  • New-CMApplicationDeployment

  • New-CMBaselineDeployment

  • New-CMConfigurationPolicyDeployment

  • New-CMPackageDeployment

  • New-CMSoftwareUpdateDeployment

  • New-TaskSequenceDeployment

Suporte de pipeline de objetos melhorado

Set-CM*Deployment, Remove-CM*Deployment e Get-CM*DeploymentStatus suportam agora totalmente o pipeline de objetos.

Os cmdlets de Implementação da funcionalidade>Start-CM<foram preteridos

Os seguintes cmdlets de Implementação da funcionalidade>Start-CM<foram preteridos. Os cmdlets de substituição podem diferir em nomes de parâmetros, mas devem ter funcionalidades idênticas e, em alguns casos, melhoradas.

  • Start-CMApplicationDeployment (substituído por New-CMApplicationDeployment)

  • Start-CMPackageDeployment (substituído por New-CMPackageDeployment)

  • Start-CMBaselineDeployment (substituído por New-CMBaselineDeployment)

  • Start-CMConfigurationPolicyDeployment (substituído por New-CMConfigurationPolicyDeployment)

  • Start-CMTaskSequenceDeployment (substituído por New-CMTaskSequenceDeployment)

  • Start-CMSoftwareUpdateDeployment (substituído por New-CMSoftwareUpdateDeployment)

Get-CMResultantSettings

Este cmdlet irá obter as definições de cliente resultantes para uma coleção, dispositivo ou utilizador.

Atualizações do pacote de atualização do sistema operativo

Foram adicionados novos cmdlets para criar e modificar agendas de atualização do pacote de atualização do sistema operativo.

  • Clear-CMOperatingSystemUpgradeUpdateSchedule

  • Get-CMOperatingSystemUpgradeUpdateSchedule

  • New-CMOperatingSystemUpgradeUpdateSchedule

  • Remove-CMOperatingSystemUpgradeUpdateSchedule

Remove-CMSoftwareUpdateFromGroup

Este cmdlet removerá uma atualização de software de um grupo de atualização de software.

Alterações de cmdlets

Foram efetuadas as seguintes alterações aos cmdlets existentes para esta versão. As alterações podem ser novas funcionalidades, correções de erros ou depreciações e podem estar a falhar. Se utilizar um dos cmdlets ou áreas de funcionalidade listados nesta secção, reveja cuidadosamente as alterações para compreender como podem afetar a sua utilização.

Alterações diversas

Erros que foram corrigidos

Os objetos de SMS_EmbeddedPropertyList grandes utilizados por determinadas classes de fornecedor podem não ser corretamente consumidos pela arquitetura de cmdlets, o que leva a um comportamento indefinido ao obter ou definir estes valores.

Determinadas combinações de alterações a políticas antimalware ou definições de cliente podem fazer com que seja gerada uma política inválida. Quando estiver neste estado, o Fornecedor de SMS devolverá um erro "A instância não é uma configuração do agente de cliente válida".

Os cmdlets para configurar pontos de gestão e pontos de atualização de software adicionaram o parâmetro EnableCloudGateway para ativar estas funções para utilização com o gateway de gestão da cloud.

Configuração da janela de manutenção do site

Alterações não interruptivas

Os cmdlets CMMaintenanceWindow suportam agora a configuração de janelas de manutenção para sites. A saída de Get-CMSite pode ser colocada em pipeline para Novo, Remover ou Set-CMMaintenanceWindow para configurar as janelas de manutenção de um site.

Add-CMDeploymentType

Alterações interruptivas

O suporte para a criação de tipos de implementação Nokia foi removido.

Add-CMDeviceAfinityToUser

Erros que foram corrigidos

O cmdlet pode falhar inesperadamente com um erro ObjectNotFound .

Add-CMDistributionPoint

Erros que foram corrigidos

O cmdlet permite-lhe configurar um ponto de distribuição como compatível com Internet quando o HTTPS não está ativado.

Alterações não interruptivas

Foi adicionado o parâmetro AllowProxyTraffic .

O parâmetro InstallInternetServer anteriormente não utilizado altera agora a configuração do ponto de distribuição.

Preterições

O parâmetro UseComputerAccount foi preterido. Para utilizar uma conta de computador, defina UserName como $null.

Add-CMEnrollmentPoint

Erros que foram corrigidos

A função do ponto de inscrição não tem definições de configuração no objeto criado.

Add-CMEnrollmentProxyPoint

Alterações não interruptivas

Foi adicionado o parâmetro ServiceHost para permitir a especificação de um ponto de inscrição remoto.

Add-CMIntuneSubscription

Erros que foram corrigidos

O parâmetro ContactEmail não pode ser definido como um valor nulo ou vazio.

Add-CMMulticastServicePoint

Erros que foram corrigidos

O UserName não valida para a formatação domain\user correta.

Os parâmetros StartUdpPort e EndUdpPort não validam valores para determinadas configurações incorretas.

Os parâmetros StartIPAddress e EndIPAddress não validam valores para determinadas configurações incorretas.

Alterações não interruptivas

Parâmetro UseAnyRangeIP adicionado.

Preterições

O parâmetro ClientTransferRate já não é suportado.

Approve-CMUserDeviceAffinityRequest

Erros que foram corrigidos

O cmdlet permite aprovar um pedido de afinidade processado anteriormente.

Convert-CMSchedule

Erros que foram corrigidos

O parâmetro InputObject não aceita o objeto de agendamento em pipeline.

Deny-CMUserDeviceAffinityRequest

Erros que foram corrigidos

O cmdlet permite negar um pedido de afinidade processado anteriormente.

Get-CMAlert

Erros que foram corrigidos

Não é possível obter alertas do estado de funcionamento do cliente ou do endpoint protection.

Get-CMSiteStatusMessage

Alterações não interruptivas

Os parâmetros ComputerName, Severity e SiteCode aceitam agora valores de matriz.

Foram adicionados os parâmetros MessageId, Module, Component e FilterHashTable para filtragem adicional.

Todos os parâmetros de filtro baseados em cadeias aceitam agora carateres universais.

Get-CMWindowsEnrollmentProfilePackage

Erros que foram corrigidos

Não é possível especificar o cmdlet sem parâmetros.

Import-CMComputerInformation

Alterações interruptivas

O cmdlet falhará se importar um registo que já existe e o novo parâmetro MergeIfExist não for especificado.

Import-CMDriver

Erros que foram corrigidos

Quando a ImportFolder é utilizada, os pacotes de controladores podem utilizar mais espaço do que o esperado.

Install-CMClient

Alterações não interruptivas

Foi adicionado suporte para objetos em pipeline de Get-CMDevice e Get-CMResource.

Invoke-CMRemoteControl

Erros que foram corrigidos

O cmdlet não aceita um objeto em pipeline de Get-CMSiteSystemServer.

Não é possível direcionar um servidor do sistema de sites para controlo remoto se não for também um computador cliente.

New-CMActiveDirectoryForest

Alterações não interruptivas

Foi adicionado o parâmetro UserName para permitir a configuração da conta de deteção.

Foi adicionado o parâmetro AddPublishingSite .

New-CMApplicationDeployment

Alterações não interruptivas

Foi adicionado o parâmetro UpdateSupersedence .

New-CMBoundaryGroup

Alterações interruptivas

FastLink é o único valor suportado para a tabela hash no parâmetro AddSiteSystemServer . O suporte para todos os outros valores foi removido.

New-CMCertificateProfilePfx

Erros que foram corrigidos

O valor do parâmetro KeyStorageProvider pode não ser aplicado conforme esperado para o perfil de certificado recentemente criado.

New-CMGlobalCondition

Alterações interruptivas

O suporte para a criação de condições globais nokia foi removido.

New-CMProgram

Alterações não interruptivas

Foi adicionado o parâmetro AddSupportedOperatingSystemPlatform .

New-CMSoftwareUpdateAutoDeploymentRule

Erros que foram corrigidos

O valor do parâmetro MicrosoftAsVendor pode não ser aplicado à regra.

Alterações não interruptivas

Foi adicionado o parâmetro Vendor para suportar patches de terceiros.

Parâmetro GenerateFailureAlert adicionado.

New-CMSoftwareUpdateDeployment

Alterações não interruptivas

Foi adicionado o parâmetro RequirePostRebootFullScan .

New-CMStandaloneMedia

Alterações não interruptivas

Foram adicionados os parâmetros MediaStartDate e MediaExpirationDate para suportar a expiração do suporte de dados.

Foram adicionados os parâmetros Application, DriverPackage e Package para adicionar conteúdos multimédia adicionais.

New-CMStatusMessageQuery

Erros que foram corrigidos

A consulta criada pode não aparecer na localização esperada da consola do administrador.

New-CMWindowsEnrollmentProfile

Erros que foram corrigidos

O parâmetro EnrollmentProxyPoint pode ser definido como um valor nulo ou vazio.

O valor do parâmetro SiteCode pode fazer com que ocorra um erro de validação na consola do administrador.

Remove-CMResource

Erros que foram corrigidos

A remoção de um recurso não remove as associações de migração de estado.

Remove-CMWindowsEnrollmentProfilePackage

Erros que foram corrigidos

O erro AmbiguousParameterSet pode ser gerado ao executar o cmdlet.

Set-CMActiveDirectoryForest

Alterações não interruptivas

Foi adicionado o parâmetro UserName para permitir a configuração da conta de deteção.

Foram adicionados os parâmetros AddPublishingSite e RemovePublishingSite .

Set-CMAdvancedThreatProtectionPolicy

Erros que foram corrigidos

Aumentar ou diminuir a prioridade pode fazer com que seja devolvido um erro ObjectNotFound .

Set-CMAntimalwarePolicy

Erros que foram corrigidos

O WhatIf pode não apresentar o nome da política esperado.

As definições de proteção em tempo real não podem ser alteradas ao utilizar um objeto em pipeline.

Alterações não interruptivas

O cmdlet aceita agora entradas em pipeline de Get-CMAntimalwarePolicy.

Set-CMApplication

Alterações não interruptivas

Foram adicionados os parâmetros AddSupportContact, AddOwner, RemoveSupportContact, RemoveOwner, ClearSupportContact e ClearOwner para suportar modificações no local de contactos ou proprietários de suporte.

Set-CMAppVVirtualEnvironment

Erros que foram corrigidos

PassThru não devolve o objeto mais atualizado.

Set-CMBaseline

Erros que foram corrigidos

PassThru não devolve um objeto SMS_ConfigurationItem.

Alterações não interruptivas

ClearRequiredConfigurationItem adicionado, ClearProhibitedConfigurationItem, ClearOptionalConfigurationItem, ClearOSConfigurationItem, ClearSoftwareUpdate, ClearBaseline, RemoveRequiredConfigurationItem, RemoveOptionalConfigurationItem, RemoveProhibitedConfigurationItemRemoveOSConfigurationItem, RemoveSoftwareUpdate, RemoveBaseline, Parâmetros AddSoftwareUpdate e AddBaseline.

Set-CMBoundaryGroup

Alterações interruptivas

FastLink é o único valor suportado para a tabela hash no parâmetro AddSiteSystemServer . O suporte para todos os outros valores foi removido.

Set-CMCertificateProfileTrustedRootCA

Erros que foram corrigidos

A utilização do pipeline de objeto pode causar um erro ParameterBindingException .

Set-CMClientPushInstallation

Alterações não interruptivas

Foram adicionados os parâmetros AddAccount e RemoveAccount para suportar modificações no local das contas push do cliente.

Set-CMClientSettingComputerAgent

Erros que foram corrigidos

O valor do parâmetro HealthAttestationUrl não é necessário se EnableHealthAttestation ou UseOnPremisesHealthAttestation estiverem definidos como verdadeiros.

Set-CMComputerAssociation

Alterações não interruptivas

Foi adicionado o parâmetro MigrationId .

Set-CMDeploymentType

Alterações interruptivas

O suporte para modificar tipos de implementação Nokia foi removido.

Set-CMDiscoveryMethod

Erros que foram corrigidos

O valor PollingSchedule pode não ser aplicado corretamente ao método de deteção.

Set-CMDistributionPoint

Erros que foram corrigidos

O cmdlet permite-lhe configurar um ponto de distribuição como compatível com Internet quando o HTTPS não está ativado.

Alterações não interruptivas

Foi adicionado o parâmetro AllowProxyTraffic .

O parâmetro InstallInternetServer anteriormente não utilizado altera agora a configuração do ponto de distribuição.

Preterições

O parâmetro UseComputerAccount foi preterido. Para utilizar uma conta de computador, defina UserName como $null.

Set-CMEmailNotificationComponent

Alterações não interruptivas

Parâmetro UseSsl adicionado.

Set-CMFileReplicationRoute

Erros que foram corrigidos

O parâmetro FileReplicationAccountName não pode ser definido como um valor nulo ou vazio.

Set-CMHierarchySetting

Alterações não interruptivas

Foram adicionados os parâmetros ExclusionCollection, ExclusionCollectionId, ExclusionCollectionName e EnableExclusionCollection para configurar exclusões de atualização de cliente.

Set-CMIntuneSubscription

Erros que foram corrigidos

O parâmetro ContactEmail não pode ser definido como um valor nulo ou vazio.

Alterações não interruptivas

O parâmetro MaximumUserDevice suporta agora um valor entre 1 e 15.

Set-CMIntuneSubscriptionWindowsPhoneProperty

Erros que foram corrigidos

O cmdlet pode falhar inesperadamente com um erro AetCleanupFailure .

Set-CMMaintenanceTask

Erros que foram corrigidos

O parâmetro PassThru não faz com que um objeto seja devolvido.

Set-CMMulticastServicePoint

Erros que foram corrigidos

O parâmetro UserName não valida o valor para a formatação domain\user correta.

Os parâmetros StartUdpPort e EndUdpPort não validam valores para determinadas configurações incorretas.

Os parâmetros StartIPAddress e EndIPAddress não validam valores para determinadas configurações incorretas.

Alterações não interruptivas

Parâmetro UseAnyRangeIP adicionado.

Preterições

O parâmetro ClientTransferRate já não é suportado.

Set-CMProgram

Alterações não interruptivas

Foram adicionados os parâmetros AddSupportedOperatingSystemPlatform, RemoveSupportedOperatingSystemPlatform e RunOnAnyPlatform .

Set-CMSite

Erros que foram corrigidos

RemoveClientRequestServiceType pode não remover corretamente o valor especificado.

Alterações não interruptivas

Foram adicionados os parâmetros SiteSystemCollectionBehavior, ThresholdOfSelectCollectionMax, ThresholdOfSelectCollectionByDefault e ThresholdOfSelectCollectionMax para configurar limiares de coleção de dispositivos para um site.

Set-CMSiteSummaryTask

Erros que foram corrigidos

O parâmetro PassThru não faz com que um objeto seja devolvido.

Set-CMSoftwareUpdateAutoDeploymentRule

Erros que foram corrigidos

O valor do parâmetro MicrosoftAsVendor pode não ser aplicado à regra.

Alterações não interruptivas

Foi adicionado o parâmetro Vendor para suportar patches de terceiros.

Parâmetro GenerateFailureAlert adicionado.

Set-CMSoftwareUpdateDeployment

Alterações não interruptivas

Foi adicionado o parâmetro RequirePostRebootFullScan .

Set-CMSoftwareUpdatePointComponent

Erros que foram corrigidos

EnableSynchronization e Schedule parameter usage (Utilização de parâmetros de agendamento) podem fazer com que seja gerado um aviso incorrido ou que o agendamento não seja modificado conforme esperado.

Set-CMStatusFilterRule

Erros que foram corrigidos

As alterações ao valor do parâmetro Priority podem não ser aplicadas à regra do filtro de estado.

Set-CMTaskSequence

Preterições

O parâmetro UseDefaultText foi preterido. Para utilizar o texto predefinido, defina Texto Personalizado para $null.

Set-CMWindowsEnrollmentProfile

Erros que foram corrigidos

O parâmetro authority não está disponível em todos os conjuntos de parâmetros.