Alterações na Biblioteca Cmdlet do Gestor de Configuração para a versão 1902

Aplica-se a: Gestor de Configuração (Filial Atual)

Mudanças importantes

Novos cmdlets

Get-CMBoundaryGroupSiteSystem

Utilize este cmdlet para obter o sistema de local em grupo de fronteira especificado.

Get-CMBoundaryGroupSiteSystem -Id $boundaryGroup.GroupID 

Get-CMDistributionPointDriveInfo

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

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

Invoke-CMAnalyzePackage

Utilize este cmdlet para analisar um pacote específico.

Invoke-CMAnalyzePackage -PackageName $packageName 

Invoke-CMConvertPackage

Utilize este cmdlet para converter uma embalagem específica numa aplicação.

Invoke-CMConvertPackage -PackageName $packageName

New-CMScript

Utilize este cmdlet para criar um novo script PowerShell. Só suporta scripts que não contêm parâmetros.

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

Set-CMClientSettingDeliveryOptimization

Utilize este cmdlet para definir as definições do cliente para a funcionalidade de Otimização de Entrega.

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

Set-CMClientSettingWindowsAnalytics

Utilize este cmdlet para definir as definições do cliente para a funcionalidade 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 preprecados

Nenhum

Problemas conhecidos

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

Get-CMAadConditionalAccessPolicy e Set-CMAadConditionalAccessPolicy

Estes cmdlets requerem um ambiente PowerShell de 64 bits.

Solução

• Nenhum

Import-CMSecurityRole

O Cmdlet pode falhar com um erro do DirectoryNotFoundException que localiza o ficheiro SecuredRoles.xsd .

Solução

• Ligue Import-Module contra o ConfigurationManager.psd1 ficheiro, e não o caminho lógico ou nome do módulo.

Set-CMSoftwareUpdatePoint

As alterações ao Horário podem não ser apresentadas na consola Do Gestor de Configuração, mesmo que o objeto subjacente ao Fornecedor de SMS tenha sido alterado.

Solução

• Desista e relançe a consola Do Gestor de Configuração.

Rastreio e recuperação de recursos (beta)

Esta versão adiciona novos cmdlets para suportar o rastreio de sms provider objetos usados pelo tempo de execução PowerShell, e para limpar estes recursos quando já não são necessários.

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

Quando Start-CMObjectTracking funciona, o tempo de execução PowerShell rastreia IResultObject os objetos criados pelos cmdlets da Biblioteca Cmdlet. Para os cmdlets que não são limpos .Dispose() manualmente, reclame-os Disconnect-CMTrackedObject utilizando-os contra um objeto individual.

Exemplo

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

# Reclaim all tracked objects
Disconnect-CMTrackedObject -All

Uma vez recuperado um objeto, não pode mais ser reutilizado ou passado para outro cmdlet através do oleoduto do objeto.

Stop-CMObjectTracking pode ser usado para desligar o rastreio de objetos. Os objetos previamente atribuídos permanecem ativos.

Os recursos não reclamados podem fazer com que o Fornecedor de SMS aumente os erros de violação de quotas. Estas questões de quota manifestam-se tipicamente de trabalhar com grandes conjuntos de objetos do Fornecedor de SMS ou em ambientes de longa duração.

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.

Add-CMDeviceAffinityToUser

Insetos que foram corrigidos

• Add/Remove-CMDeviceAffinityToUser -UserId/-UserName need use "-DeviceId/-DeviceName" em conjunto.

Alterações não-quebrando

• Verificação de parâmetros adicionada para -DeviceID e -DeviceName, o utilizador deve especificar pelo menos um deles.

Add-CMDeviceCollectionDirectMembershipRule

Insetos que foram corrigidos

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

Alterações não-quebrando

• Adicionei um recurso desaparecido.

Add-CMDistributionPoint

Alterações não-quebrando

• Parâmetro "Enable-EnableLedbat" adicionado para ativar/desativar LEDBAT no DP

Add-CMScriptDeploymentType

Insetos que foram corrigidos

• Add-CMScriptDeploymentType não alinhar com a UI por padrão

Alterações não-quebrando

• Modificou o código de inicialização para alinhar com ui (tempo estimado de instalação = 0, requisito de logon=apenas quando um utilizador está ligado).

Approve-CMApprovalRequest

Alterações não-quebrando

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

Get-CMDevice

Insetos que foram corrigidos

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

Alterações não-quebrando

• Adicione dois novos parâmetros de comutação para permitir ao cliente especificar a classe da saída:

  • -ReturnCollectionMemember: forçará a devolução da classe de membro da recolha de SMS
  • -ReturnResource: forçará a instância de retorno da classe SMS_Resource.

  Se utilizar o parâmetro padrão sem ReturnCollectionMemember/ReturnResource, então o comportamento seria o mesmo de 1802/1810: a instância devolvida poderia estar em classes diferentes com diferentes parâmetros especificados.

Get-CMPackage

Insetos que foram corrigidos

• Get-CMPackage precisa de um interruptor rápido

Alterações não-quebrando

• Parâmetro adicionado -Fast para suportar consulta rápida.

Import-CMDriver

Insetos que foram corrigidos

• Set-CMDriver -SuportadoPlatformName falhará para matrizes

Alterações não-quebrando

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

Invoke-CMScript

Insetos que foram corrigidos

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

Alterações não-quebrando

• Corrigi a validação do tipo.

New-CMActiveDirectoryForest

Insetos que foram corrigidos

• Criação de Ative Directory Forest - O utilizador não funciona via Powershell, apenas se for criado através do GUI.

Alterações não-quebrando

• Importou a conta para a conta global depois de o utilizador ter definido a credencial.
• Adicionado novo parâmetro -Password para criar credencial com senha.

New-CMApplication

Insetos que foram corrigidos

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

Alterações não-quebrando

• Permitir $null para Proprietário/SupportContact ao criar uma nova aplicação, o valor padrão seria o utilizador atual.
• Adicione novos parâmetros para proprietário/SupportContact para suportar a entrada do array.

New-CMApplicationDeployment

Alterações não-quebrando

• Adicionado novo parâmetro SubstituToastNotificationWithDialog (Boolean), o administrador pode especificar se deve substituir notificações de torradas por diálogo quando o software necessário estiver disponível na máquina do cliente. É um parâmetro opcional e falso por defeito.

New-CMCoManagementPolicy

Alterações não-quebrando

• Suporte adicional para novas cargas de trabalho (DCWorkloadEnabled, O365WorkloadEnabled, ClientAppsWorkloadEnabled).

New-CMDetectionClauseWindowsInstaller

Insetos que foram corrigidos

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

Alterações não-quebrando

• Modificou a lógica da inicialização do tipo de dados para se certificar de que está correta quando especificar o interruptor Existência.

New-CMOperatingSystemImageUpdateSchedule

Alterações não-quebrando

• Novo parâmetro adicionado às alterações de correspondência feitas para criar o assistente de agenda na UI:
  • -Remover Datas de Supervisão

New-CMOperatingSystemUpgradeUpdateSchedule

Alterações não-quebrando

• Novo parâmetro adicionado às alterações de correspondência feitas para criar o assistente de agenda na UI:
  • -Remover Datas de Supervisão

New-CMPackageDeployment

Insetos que foram corrigidos

• New-CMPackageDeployment tem avisos inconsistentes

Alterações não-quebrando

• Modificou o comportamento padrão da opção SlowNetwork para alinhar com a UI.

New-CMStatusFilterRule

Insetos que foram corrigidos

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

Alterações não-quebrando

• Adicione mais condições para iD/verificação de valor para desbloquear caso sem -PropertyID especificado.
• Lógica adicional para permitir o id de propriedade definido pelo utilizador = 'Package ID' quando a fonte é 'Cliente'.

New-CMTaskSequenceDeployment

Insetos que foram corrigidos

• Incapaz de definir o tempo de validade de uma implementação da sequência de tarefas
• New-CMTaskSequenceDeployment, $result não conseguir obter o objeto deste cmdlet.

Alterações não-quebrando

• Adicionado pseudónimo "DeploymentExpireDateTime" ao parâmetro -DeadlineDateTime para alinhar com Set-cmdlet.
• Removido o bloco de utilização, o objeto de implantação não deve ser eliminado.

New-CMTaskSequenceMedia

Alterações não-quebrando

• Um novo parâmetro adicionado para corresponder às alterações adicionadas à criação de mídia de sequência de tarefas UI:
  • -Carrinho Temporário (pseudónimo "TemporaryDirectory", "StagingArea")

New-CMTSStepRunPowerShellScript

Alterações interruptivas

• Conjuntos de parâmetros adicionados: RunScriptFromSource, RunScriptFromPackage.
• Os parâmetros do PackageID e do PackageName já não são obrigatórios porque os utilizadores podem, em alternativa, introduzir novo parâmetro SourceScript

Alterações não-quebrando

• Novos parâmetros adicionados às alterações de correspondência feitas ao passo do script da Run Power Shell no editor de sequência de tarefas UI:
  • -Código de Origem
  • -WorkingDirectory
  • -Nome Variavel de Saída
  • -TimeOut
  • -UserName
  • -Password
  • -Códigos de Sucesso

Remove-CMDeviceAffinityFromUser

Insetos que foram corrigidos

• Add/Remove-CMDeviceAffinityToUser -UserId/-UserName need use "-DeviceId/-DeviceName" em conjunto.

Alterações não-quebrando

• Verificação de parâmetros adicionada para -DeviceID e -DeviceName, o utilizador deve especificar pelo menos um deles.

Set-CMActiveDirectoryForest

Insetos que foram corrigidos

• Criação de Ative Directory Forest - O utilizador não funciona via Powershell, apenas se for criado através do GUI.

Alterações não-quebrando

• Importou a conta para a conta global depois de o utilizador ter definido a credencial.
• Adicionado novo parâmetro -Password para criar credencial com senha.

Set-CMApplicationDeployment

Alterações não-quebrando

• Adicionado novo parâmetro SubstituToastNotificationWithDialog (Boolean), o administrador pode especificar se deve substituir notificações de torradas por diálogo quando o software necessário estiver disponível na máquina do cliente. É um parâmetro opcional e falso por defeito.

Set-CMClientSetting

Alterações não-quebrando

• Adicionado novo parâmetro SubstituToastNotificationWithDialog (Boolean), o administrador pode especificar se deve substituir notificações de torradas por diálogo quando a máquina necessita de ser reiniciada. É um parâmetro opcional e falso por defeito.

Set-CMClientSettingComputerRestart

Alterações não-quebrando

• Adicionado novo parâmetro SubstituToastNotificationWithDialog (Boolean), o administrador pode especificar se deve substituir notificações de torradas por diálogo quando a máquina necessita de ser reiniciada. É um parâmetro opcional e falso por defeito.

Set-CMComplianceRuleExistential

Insetos que foram corrigidos

• Set-CMComplianceRuleExistential -A regra não funciona para definir o valor da regra.
• Set-CMComplianceRuleExistential -ExpectValue não permite que o conjunto seja definido para número negativo, sem o parâmetro selecionado [-Existência Ocorre] definido com sucesso.

Alterações não-quebrando

• Modificou a função WarnIgnoredParameter para se certificar de que chamaria IsBoundParameterUsed com parâmetro silencioso='true' para evitar erros de bloqueio quando o cmdlet da criança sobrepõe o parâmetro base como parâmetro não público.
• A validação movida para o resultado esperado para um lugar comum.

Set-CMDiscoveryMethod

Insetos que foram corrigidos

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

Alterações não-quebrando

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

Set-CMDistributionPoint

Alterações não-quebrando

• Parâmetro "Enable-EnableLedbat" adicionado para ativar/desativar LEDBAT no DP

Set-CMDriver

Insetos que foram corrigidos

• Set-CMDriver -SuportadoPlatformName falhará para matrizes

Alterações não-quebrando

• Emissão de valor de matriz fixa para o parâmetro SupportPlatformName.
• Adicionados novos parâmetros para SuportadoPlatform: -AddSupportedPlatformName; -remover O nome de supportedPlatformName; -ClearSupportedPlatform

Depreciação

• Parâmetro precotado: -Nome de Pré-Forma Suportado

Set-CMManagementPoint

Alterações interruptivas

• Modificou a validação do parâmetro para alinhar com a UI, código adicionado para redefinir o tipo de ligação do cliente quando ativar/desativar o gateway de nuvem. É uma mudança de rutura, uma vez que bloquearíamos o utilizador para ativar o gateway de nuvem (-EnableCloudGateway) sem SSL.

Insetos que foram corrigidos

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

Set-CMStatusFilterRule

Insetos que foram corrigidos

• Set-CMStatusFilterRule não funciona com a definição de ID do pacote

Alterações não-quebrando

• Permitir ao utilizador definir a propriedade sem especificar novamente a fonte, o diferente com a UI é que precisamos que o utilizador especifique -PropertyID e -PropertyValue juntos.
• Código adicionado para evitar a mensagem de aviso vazia quando o objeto não existe.

Set-CMTSStepRunPowerShellScript

Alterações não-quebrando

• Novos parâmetros adicionados às alterações de correspondência feitas ao passo do script da Run Power Shell no editor de sequência de tarefas UI:
  • -Código de Origem
  • -WorkingDirectory
  • -Nome Variavel de Saída
  • -TimeOut
  • -UserName
  • -Password
  • -Códigos de Sucesso

Set-CMWindowsFirewallPolicy

Insetos que foram corrigidos

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

Alterações não-quebrando

• Corrigi a validação do tipo.

Como fornecer problemas de feedback ou relatório

Muitas das correções e melhorias descritas neste artigo são resultado do seu feedback.

Para submeter relatórios de bugs, use enviar um sorriso na consola Do Gestor de Configuração. Para novos pedidos de funcionalidades, utilize o UserVoice.