Configuration Manager alterações na Biblioteca de Cmdlets para a versão 1902

Aplica-se ao: Gerenciador de Configurações (Ramificação Atual)

Alterações importantes

Novos cmdlets

Get-CMBoundaryGroupSiteSystem

Use esse cmdlet para obter o sistema de sites no grupo de limites especificado.

Get-CMBoundaryGroupSiteSystem -Id $boundaryGroup.GroupID 

Get-CMDistributionPointDriveInfo

Use este cmdlet para obter informações de unidade de ponto de distribuição.

$dp = Get-CMDistributionPoint -SiteSystemServerName $ReferenceSiteSystemServerName 
$dp | Get-CMDistributionPointDriveInfo     

Invoke-CMAnalyzePackage

Use este cmdlet para analisar um pacote específico.

Invoke-CMAnalyzePackage -PackageName $packageName 

Invoke-CMConvertPackage

Use este cmdlet para converter um pacote específico em um aplicativo.

Invoke-CMConvertPackage -PackageName $packageName

New-CMScript

Use este cmdlet para criar um novo script do PowerShell. Ele só dá suporte a scripts que não contêm nenhum parâmetro.

New-CMScript -ScriptName "CMScript" -ScriptText 'Write-Host "New Script"'
New-CMScript -ScriptName "ImportScript" -ScriptFile \\abc\importedscript.ps1

Set-CMClientSettingDeliveryOptimization

Use esse cmdlet para definir as configurações do cliente para o recurso de Otimização de Entrega.

[Default] Set-CMClientSettingDeliveryOptimization -DefaultSetting -Enable $true
[Customized] Set-CMClientSettingDeliveryOptimization -Name $ReferenceClientDeviceSettingName -Enable $true

Set-CMClientSettingWindowsAnalytics

Use esse cmdlet para definir as configurações do cliente para o recurso do Windows Analytics.

[Default] Set-CMClientSettingWindowsAnalytics -DefaultSetting -Enable $true -CommercialIdKey $commercialIdKey -Win10Telemetry EnhancedLimited -EnableEarlierTelemetry $true -IEDataCollectionOption AllZones
[Customized] Set-CMClientSettingWindowsAnalytics -Name $ReferenceClientDeviceSettingName -Enable $true -CommercialIdKey $commercialIdKey -Win10Telemetry EnhancedLimited -EnableEarlierTelemetry $true -IEDataCollectionOption AllZones

Cmdlets removidos

Nenhum

Cmdlets preteridos

Nenhum

Problemas conhecidos

Os itens a seguir são problemas conhecidos com a Biblioteca cmdlet que não são resolvidos nesta versão.

Get-CMAadConditionalAccessPolicy e Set-CMAadConditionalAccessPolicy

Esses cmdlets exigem um ambiente do PowerShell de 64 bits.

Solução alternativa

• Nenhum

Import-CMSecurityRole

O cmdlet pode falhar com um erro directoryNotFoundException localizando o arquivo SecuredRoles.xsd.

Solução alternativa

• Chame Import-Module no ConfigurationManager.psd1 arquivo e não no caminho lógico ou no nome do módulo.

Set-CMSoftwareUpdatePoint

As alterações no Agendamento podem não ser mostradas no console Configuration Manager, embora o objeto provedor de SMS subjacente tenha sido alterado.

Solução alternativa

• Desista e relançar o console Configuration Manager.

Acompanhamento e recuperação de recursos (beta)

Esta versão adiciona novos cmdlets para dar suporte ao acompanhamento de objetos do Provedor de SMS usados pelo runtime do PowerShell e para limpar esses recursos quando eles não forem mais necessários.

• Disconnect-CMTrackedObject
• Start-CMObjectTracking
• Stop-CMObjectTracking

Quando você executa Start-CMObjectTracking, o runtime do PowerShell rastreia IResultObject objetos criados por cmdlets da Biblioteca de Cmdlet. Para cmdlets que não são limpos manualmente com .Dispose(), recupere-os usando Disconnect-CMTrackedObject em um objeto individual.

Exemplo

# Reclaim a single tracked object
$o | Disconnect-CMTrackedObject

# Reclaim all tracked objects
Disconnect-CMTrackedObject -All

Depois que um objeto é recuperado, ele não pode mais ser reutilizado ou passado para outro cmdlet por meio do pipeline de objeto.

Stop-CMObjectTracking pode ser usado para desativar o rastreamento de objetos. Os objetos alocados anteriormente permanecem ativos.

Recursos não reclamados podem fazer com que o Provedor de SMS aumente erros de violação de cota. Esses problemas de cota normalmente se manifestam por trabalhar com grandes conjuntos de objetos provedores de SMS ou em ambientes de longa execução.

Alterações de cmdlet

As seguintes alterações foram feitas em cmdlets existentes nesta versão. As alterações podem ser novas funcionalidades, correções de bugs ou preterição. Algumas alterações podem estar quebrando. Se você usar um dos cmdlets ou áreas de recursos listados nesta seção, examine cuidadosamente as alterações para entender como elas podem afetar seu uso.

Add-CMDeviceAffinityToUser

Bugs corrigidos

• Add/Remove-CMDeviceAffinityToUser -UserId/-UserName precisa usar "-DeviceId/-DeviceName" juntos.

Alterações sem interrupção

• A verificação de parâmetro adicionada para -DeviceID e -DeviceName, o usuário deve especificar pelo menos uma delas.

Add-CMDeviceCollectionDirectMembershipRule

Bugs corrigidos

• Quando o mesmo recurso é adicionado à mesma coleção usando o comando 'Add-CMDeviceCollectionDirectMembershipRule' no PowerShell, ele mostra um aviso em branco "AVISO: " e não dá erro "Um objeto com o nome especificado já existe".

Alterações sem interrupção

• Adicionado um recurso ausente.

Add-CMDistributionPoint

Alterações sem interrupção

• Adicionado parâmetro "-EnableLedbat" para habilitar/desabilitar o LEDBAT no DP

Add-CMScriptDeploymentType

Bugs corrigidos

• Add-CMScriptDeploymentType não se alinhar com a interface do usuário por padrão

Alterações sem interrupção

• Modificou o código de inicialização para se alinhar à interface do usuário (Tempo estimado de instalação = 0, requisito de logon=somente quando um usuário está conectado).

Approve-CMApprovalRequest

Alterações sem interrupção

• Adicionado o novo parâmetro InstallActionBehavior (tem duas opções: InstallNow, InstallNonBusinessHours), o administrador pode especificar se deve instalar o aplicativo imediatamente após ele ser aprovado ou instalado durante o horário não comercial. É um parâmetro opcional e, por padrão, é igual a "InstallNow".

Get-CMDevice

Bugs corrigidos

• Get-CMDevice está ausente a propriedade SMSAssignedSites - esta estava disponível antes de 1806.

Alterações sem interrupção

• Adicionados dois novos parâmetros de comutador para permitir que o cliente especifique a classe da saída:

  • -ReturnCollectionMember: forçará a instância de retorno da classe membro da coleção sms
  • -ReturnResource: forçará a instância de retorno da classe SMS_Resource.

  Se você usar o parâmetro padrão sem ReturnCollectionMember/ReturnResource, o comportamento será igual a 1802/1810: a instância retornada pode estar em classes diferentes com parâmetros especificados diferentes.

Get-CMPackage

Bugs corrigidos

• Get-CMPackage precisa de um comutador rápido

Alterações sem interrupção

• Parâmetro adicionado -Rápido para dar suporte à consulta rápida.

Import-CMDriver

Bugs corrigidos

• Set-CMDriver -SupportedPlatformName falhará em matrizes

Alterações sem interrupção

• Problema de valor de matriz fixa para o parâmetro SupportPlatformName.

Invoke-CMScript

Bugs corrigidos

• Invoke-CMScript cmdlet está esperando um objeto que não pode ser obtido.

Alterações sem interrupção

• Corrigimos a validação de tipo.

New-CMActiveDirectoryForest

Bugs corrigidos

• Criando a Floresta do Active Directory – o usuário não funciona por meio do Powershell, somente se criado por meio da GUI.

Alterações sem interrupção

• Importou a conta para a conta global após o usuário definir a credencial.
• Adicionado novo parâmetro -Senha para criar credencial com senha.

New-CMApplication

Bugs corrigidos

• O usuário não pode especificar um parâmetro Proprietário ou SupportContact em branco com o cmdlet New-CMApplication

Alterações sem interrupção

• Permitir $null para Proprietário/SupportContact ao criar um novo aplicativo, o valor padrão seria o usuário atual.
• Adicionamos novos parâmetros para Proprietário/SupportContact para dar suporte à entrada da matriz.

New-CMApplicationDeployment

Alterações sem interrupção

• Adicionado novo parâmetro ReplaceToastNotificationWithDialog (Boolean), o administrador pode especificar se deve substituir as notificações por caixa de diálogo quando o software necessário estiver disponível no computador cliente. É um parâmetro opcional e falso por padrão.

New-CMCoManagementPolicy

Alterações sem interrupção

• Adicionado suporte para novas cargas de trabalho (DCWorkloadEnabled, O365WorkloadEnabled, ClientAppsWorkloadEnabled).

New-CMDetectionClauseWindowsInstaller

Bugs corrigidos

• Add/Set-CMMsiDeploymentType -AddDetectionClause falhou "Expressão inválida: qualquer tipo de dados de operando não corresponde ou o operador é inválido para o tipo de dados".

Alterações sem interrupção

• Modificou a lógica da inicialização do tipo de dados para verificar se ela está correta quando você especifica a opção Existência.

New-CMOperatingSystemImageUpdateSchedule

Alterações sem interrupção

• Novo parâmetro adicionado às alterações correspondentes feitas para criar o assistente de agendamento na interface do usuário:
  • -RemoveSupersedEdUpdates

New-CMOperatingSystemUpgradeUpdateSchedule

Alterações sem interrupção

• Novo parâmetro adicionado às alterações correspondentes feitas para criar o assistente de agendamento na interface do usuário:
  • -RemoveSupersedEdUpdates

New-CMPackageDeployment

Bugs corrigidos

• New-CMPackageDeployment tem avisos inconsistentes

Alterações sem interrupção

• Modificou o comportamento padrão da opção SlowNetwork para se alinhar com a interface do usuário.

New-CMStatusFilterRule

Bugs corrigidos

• New-CMStatusFilterRule não funciona conforme o esperado
• Não é possível criar uma nova regra de filtro de status com a propriedade "ID do pacote.

Alterações sem interrupção

• Adicionou mais condições para a ID da propriedade/verificação de valor para desbloquear o caso sem -PropertyID especificado.
• Lógico adicionado para permitir que o usuário defina id de propriedade = 'ID do pacote' quando a origem for 'Client'.

New-CMTaskSequenceDeployment

Bugs corrigidos

• Não é possível definir o tempo de expiração de uma implantação de sequência de tarefas
• New-CMTaskSequenceDeployment , $result não é possível obter o objeto deste cmdlet.

Alterações sem interrupção

• O alias "DeploymentExpireDateTime" foi adicionado ao parâmetro -DeadlineDateTime para se alinhar ao cmdlet Set.
• Removido o bloco de uso, o objeto de implantação não deve ser descartado.

New-CMTaskSequenceMedia

Alterações sem interrupção

• Um novo parâmetro adicionado para corresponder às alterações adicionadas à interface do usuário de criação de mídia da sequência de tarefas:
  • -TemporaryFolder (alias "TemporaryDirectory", "StagingArea")

New-CMTSStepRunPowerShellScript

Alterações quebrando

• Conjuntos de parâmetros adicionados: RunScriptFromSource, RunScriptFromPackage.
• Os parâmetros PackageID e PackageName não são mais obrigatórios porque os usuários podem, como alternativa, inserir o novo parâmetro SourceScript

Alterações sem interrupção

• Novos parâmetros adicionados às alterações correspondentes feitas à etapa executar o script do Power Shell na interface do usuário do editor de sequência de tarefas:
  • -Sourcecode
  • -Workingdirectory
  • -OutputVariableName
  • -Timeout
  • -Username
  • -Senha
  • -SuccessCodes

Remove-CMDeviceAffinityFromUser

Bugs corrigidos

• Add/Remove-CMDeviceAffinityToUser -UserId/-UserName precisa usar "-DeviceId/-DeviceName" juntos.

Alterações sem interrupção

• A verificação de parâmetro adicionada para -DeviceID e -DeviceName, o usuário deve especificar pelo menos uma delas.

Set-CMActiveDirectoryForest

Bugs corrigidos

• Criando a Floresta do Active Directory – o usuário não funciona por meio do Powershell, somente se criado por meio da GUI.

Alterações sem interrupção

• Importou a conta para a conta global após o usuário definir a credencial.
• Adicionado novo parâmetro -Senha para criar credencial com senha.

Set-CMApplicationDeployment

Alterações sem interrupção

• Adicionado novo parâmetro ReplaceToastNotificationWithDialog (Boolean), o administrador pode especificar se deve substituir as notificações por caixa de diálogo quando o software necessário estiver disponível no computador cliente. É um parâmetro opcional e falso por padrão.

Set-CMClientSetting

Alterações sem interrupção

• Adicionado novo parâmetro ReplaceToastNotificationWithDialog (Boolean), o administrador pode especificar se deve substituir as notificações por caixa de diálogo quando o computador requer a reinicialização. É um parâmetro opcional e falso por padrão.

Set-CMClientSettingComputerRestart

Alterações sem interrupção

• Adicionado novo parâmetro ReplaceToastNotificationWithDialog (Boolean), o administrador pode especificar se deve substituir as notificações por caixa de diálogo quando o computador requer a reinicialização. É um parâmetro opcional e falso por padrão.

Set-CMComplianceRuleExistential

Bugs corrigidos

• Set-CMComplianceRuleExistential -Regra não funciona para definir o valor da regra.
• Set-CMComplianceRuleExistential -ExpectedValue não permite definir como número negativo, sem selecionar parâmetro [-Existência Ocorre] definido com êxito.

Alterações sem interrupção

• Modificou a função WarnIgnoredParameter para garantir que ela chamaria IsBoundParameterUsed com parâmetro silent='true' para evitar o erro de bloqueio quando o cmdlet filho substitui o parâmetro base como parâmetro não público.
• Validação movida para o resultado esperado para um lugar comum.

Set-CMDiscoveryMethod

Bugs corrigidos

• Set-CMDiscoveryMethod não tem um parâmetro para configurar a conta de descoberta.

Alterações sem interrupção

• Adicionado novo parâmetro -UserName para especificar a conta de descoberta para a nova adição do ADContainer para AD System/User Discovery.

Set-CMDistributionPoint

Alterações sem interrupção

• Adicionado parâmetro "-EnableLedbat" para habilitar/desabilitar o LEDBAT no DP

Set-CMDriver

Bugs corrigidos

• Set-CMDriver -SupportedPlatformName falhará em matrizes

Alterações sem interrupção

• Problema de valor de matriz fixa para o parâmetro SupportPlatformName.
• Adicionados novos parâmetros para SupportedPlatform: -AddSupportedPlatformName; -RemoveSupportedPlatformName; -ClearSupportedPlatform

Preterições

• Parâmetro preterido: -SupportedPlatformName

Set-CMManagementPoint

Alterações quebrando

• Modificou a validação do parâmetro para se alinhar à interface do usuário, adicionou código para redefinir o tipo de conexão do cliente ao habilitar/desabilitar o gateway de nuvem. É uma alteração de quebra, pois bloquearíamos o usuário para habilitar o gateway de nuvem (-EnableCloudGateway) sem SSL.

Bugs corrigidos

• Set-CMManagementPoint -EnableCloudGateway, no primeiro set MP como HTTPS / EnableCloudGateway true, em seguida, defina MP como HTTP o EnableCloudGateway não deve ser verificado.

Set-CMStatusFilterRule

Bugs corrigidos

• Set-CMStatusFilterRule não funciona com a configuração da ID do pacote

Alterações sem interrupção

• Permitir que o usuário defina a propriedade sem especificar a origem novamente, o diferente com a interface do usuário é que precisamos que o usuário especifique -PropertyID e -PropertyValue juntos.
• Adicionado código para evitar mensagens de aviso vazias quando o objeto não existe.

Set-CMTSStepRunPowerShellScript

Alterações sem interrupção

• Novos parâmetros adicionados às alterações correspondentes feitas à etapa executar o script do Power Shell na interface do usuário do editor de sequência de tarefas:
  • -Sourcecode
  • -Workingdirectory
  • -OutputVariableName
  • -Timeout
  • -Username
  • -Senha
  • -SuccessCodes

Set-CMWindowsFirewallPolicy

Bugs corrigidos

• Set/Remove-CMWindowsFirewallPolicy -InputObject precisa inserir o tipo correto do New-CMWindowsFirewallPolicy.

Alterações sem interrupção

• Corrigimos a validação de tipo.