Alterações na Biblioteca Cmdlet do Gestor de Configuração para o Ramo Atual 1710
Nota
System Center Configuração O Ramo Atual 1706 é a linha de base para estas alterações. Consulte as alterações da Biblioteca Cmdlet do Gestor de Configuração para o Ramo Atual 1706 para obter mais detalhes.
Mudanças importantes
Atualizações da biblioteca de documentação
Para obter a documentação mais recente da biblioteca cmdlet, consulte a referência do módulo ConfigurationManager.
Cmdlets removidos
Os cmdlets seguintes deixaram de ser suportados e foram removidos:
- Invoke-CMAmtProvisioningDiscovery
- New-CMAmtProvisioningAccount
- Set-CMPowerControl
Cmdlets preprecados
Invoke-CMEndpointProtectionScan
eSave-CMEndpointProtectionDefinition
foram substituídosInvoke-CMClientAction
por.
Desativar a auto-criação do PSDrive
Quando o módulo ConfigurationManager.psd1 é carregado, o PowerShell tenta automaticamente criar uma ligação ao último Fornecedor de SMS que foi acedido através da consola 'Gestor de Configuração'. Em alguns cenários, este comportamento pode não ser desejável. Foi adicionada uma chave de registo por utilizador que pode desativar este comportamento e requer a criação de unidade manual. Para configurar isto, utilize a chave de registo: HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell
e desfase o valor DisableCMDriveAutoCreate
de um DWORD de 1 (a unidade de auto-criação está desativada) ou 0 (comportamento predefinido). A eliminação DisableCMDriveAutoCreate
também permite o comportamento predefinido.
Nota
Quando a criação automática de unidade é desativada, a consola Do Gestor de Configuração pode relatar um erro ao lançar uma janela PowerShell.
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 deixar feedback e relatórios de bugs, utilize o UserVoice.
Problemas conhecidos
Estes são problemas conhecidos com a Biblioteca Cmdlet que não são resolvidos nesta versão.
Get-CMAadConditionalAccessPolicy e Set-CMAadConditionalAccessPolicy
Para estes cmdlets é necessário um ambiente powershell de 64 bits.
Solução
- Nenhuma
Import-CMSecurityRole
O Cmdlet pode falhar com um erro do DirectoryNotFoundException que localiza o ficheiro SecuredRoles.xsd
.
Solução
Certifique-se de que Import-Module
é chamado contra o ConfigurationManager.psd1
ficheiro, e não o nome do caminho ou do módulo lógico.
Get-CMSiteUpdateInstallStatus
O Cmdlet pode falhar com um erro WqlQueryException.
Solução
- Utilize Invoke-CMWmiQuery para consultar diretamente a classe SMS_CM_UpdatePackTopLevelMonitoring.
Exemplo
# Note: The PackageGuid value can be determined by running Get-CMSiteUpdateInstallStatus -Verbose and viewing the query details.
Invoke-CMWmiQuery "SELECT * FROM SMS_UpdatePackTopLevelMonitoring WHERE PackageGuid='...' ORDER BY StageId ASC"
Set-CMSoftwareUpdatePoint
As alterações ao Horário podem não ser refletidas 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.
Novos cmdlets
Estes são novos cmdlets adicionados para esta versão que adicionam uma nova funcionalidade ou melhoram a funcionalidade dos cmdlets existentes.
Cmdlets de associação de dispositivos
Get-CMResultantCollection
obterá as coleções associadas a um dispositivo.
Get-CMResultantDeployment
conseguirá que as implementações sejam direcionadas para um dispositivo.
Gestão da classe de inventário de clientes
Foram adicionados novos cmdlets para apoiar a modificação das classes de inventário utilizadas para o inventário dos clientes.
- Get-CMInventoryClass
- New-CMInventoryReportClass
Sequências de tarefas
Foram adicionados novos cmdlets para suportar a modificação dos passos da sequência de tarefas.
- Comandos de sequência de tarefas (Verbos de obter, novos, remover e definir suportados)
- CMTaskSequenceStepApplyOperatingSystem
- CMTaskSequenceStepApplyWindowsSetting
Rastreio e recuperação de recursos (BETA)
Foram adicionados novos cmdlets para apoiar o rastreio de sms provider objetos usados pelo tempo de funcionaamento PowerShell, e para limpar estes recursos quando já não são necessários.
- Disconnect-CMTrackedObject
- Start-CMObjectTracking
- Stop-CMObjectTracking
Quando Start-CMObjectTracking
for executado, o tempo de execução PowerShell rastreará IResultObject
os objetos criados pelos cmdlets da Biblioteca Cmdlet. Os cmdlets que não são limpos manualmente .Dispose()
podem ser recuperados utilizando Disconnect-CMTrackedObject
um objeto individual.
Exemplo
# Reclaim all tracked objects
$o | Disconnect-CMTrackedObject```), or ```Disconnect-CMTrackedObject -All
Note que uma vez recuperado um objeto, não pode mais ser reutilizado ou passado para outro cmdlet através do pipeline do objeto.
Stop-CMObjectTracking
pode ser usado para desligar o rastreio de objetos. Note que os objetos previamente atribuídos permanecerão ativos.
Os recursos não reclamados podem fazer com que os erros de Violação de Quotas sejam levantados pelo Fornecedor de SMS. Estas questões normalmente manifestam-se de trabalhar com conjuntos muito grandes de objetos fornecedores de SMS ou em ambientes de execução muito longos
Nota
Esta é uma característica experimental e pode estar sujeita a alterações ou remoção em uma versão futura. Esta funcionalidade é opt-in e não está ativada por padrão.
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.
Definição de conformidade e cmdlets de regra
Insetos que foram corrigidos
Regra O valor dedescrição pode não se aplicar à Regra. (Cmdlets que suportam a criação ou modificação de regras)
Não é possível definir valor para a chave de registo "predefinido" (Add/Set-CMComplianceSettingRegistryKeyValue, New-CMDetectionClauseRegistryKeyValue).
NullReferenceExcepção pode ser levantada (New-CMComplianceRuleAssembly)
Suporte ao DataType em falta (Add-CMComplientSettingREgistryKeyValue)
Add-CMApplicationCatalogWebsitePoint
Insetos que foram corrigidos
Melhor tratamento e reporte de erros.
Adicionar/Set-CMDataWareWarehouseServicePoint
Alterações não-quebrando
DataWarehouseSqlPort suporta o valor da porta de 1-65535.
O parâmetro DaysOfWeek suporta agora o valor de Daily
.
Add/Set-CMExchangeServer
Insetos que foram corrigidos
O valor do parâmetro emailAddress pode não se aplicar à configuração do servidor Exchange.
Add-CMMsiDeploymentType
Insetos que foram corrigidos
O parâmetro de contentLocalização é necessário ao utilizar a deteção do script. Adicionou novos parâmetros Desinstalction e Desinstal option.
Alterações não-quebrando
Melhor validação para o parâmetro ProductCode.
Add-CMScriptDeploymentType
Alterações não-quebrando
Melhor validação para o parâmetro ProductCode. Adicionou novos parâmetros Desinstalction e Desinstal option.
Get-CMDeploymentTypeDependencyGroup
Alterações não-quebrando
O Cmdlet suporta agora o valor em pipelined a partir de Get-CMDeploymentType
.
Get-CMSiteStatusMessage
Insetos que foram corrigidos
Nem todas as mensagens são devolvidas quando filtram com o parâmetro Severidade.
Invoke-CMClientAction (anteriormente Invocação-CMClientNotification)
Alterações não-quebrando
Parâmetro ActionType que aceita todos os tipos de notificação do cliente.
Nota
RequestScriptExecution
não é apoiado neste momento.
Depreciação
NotificationType foi substituído pelo ActionType
Implantação de novos CM*
Insetos que foram corrigidos
O Cmdlet permite combinar os parâmetros CollectionId, CollectionName e Collection que podem levar a comportamentos indefinidos.
New-CMBootableMedia
Insetos que foram corrigidos
Incapaz de criar meios de comunicação como SiteBased.
New-CMWirelessProfile
Insetos que foram corrigidos
O Comandante não funciona num ambiente PowerShell de 64 bits.
O Cmdlet pode devolver um erro se especificar um valor para o parâmetro ClientCertificate.
Remove-CMCorpOwnedDevice
Insetos que foram corrigidos
Não é possível remover o dispositivo quando utilizar objetos em pipeline.
O nome do dispositivo não é reportado quando se utiliza o WhatIf ou Confirmar.
Remove-CMStateMigrationPoint
Alterações interruptivas
Será necessária uma confirmação adicional se houver dados do utilizador armazenados no ponto de migração do Estado. Nota: A força irá contornar esta confirmação.
Save-CMSoftwareUpdate
Alterações não-quebrando
Adicione os parâmetros RetryCount e RetryDelaySec para reattemptar downloads após uma falha.
Set-CMAccessAccount
Insetos que foram corrigidos
PassThru não pode devolver um objeto atualizado.
Set-CMAntimalwarePolicy
Insetos que foram corrigidos
Não é possível utilizar caracteres wildcard com o parâmetro AddExcludedFilePath.
Incapaz de configurar FallbackOrder
uma determinada política
Alterações não-quebrando
Adicionou novos parâmetros para a gestão de listas de ameaças: AddThreat, RemoveThreat e CleanThreat. O AddThreat aceita uma tabela hash com a chave como nome e com o valor de tipo Microsoft.ConfigurationManagement.Cmdlets.EP.Commands.DefaultActionMediumAndLowType
.
Depreciação
Os parâmetros ThreatName e OverrideAction foram substituídos pela AddThreat, RemoveThreat e CleanThreat.
Set-CMClientSettingComputerAgent
Depreciação
O parâmetro HealthAttestationUrl, uma vez que já não é utilizado pelo produto.
Set-CMClientSettingHardwareInventory
Alterações não-quebrando
Os parâmetros AddInventoryReportClass, CleanInventoryReportClass e RemoveInventoryReportClass suportam a modificação do inventário de hardware recolhido pelos clientes.
Set-CMMsiDeploymentType
Alterações não-quebrando
Melhor validação para o parâmetro ProductCode.
Set-CMScriptDeployment
Insetos que foram corrigidos
O objeto de aplicação no Fornecedor SMS não pode desbloquear automaticamente se o cmdlet falhar impedindo novas modificações até que o bloqueio expire.
Set-CMScriptDeploymentType
Alterações não-quebrando
Melhor validação para o parâmetro ProductCode.
Set-CMSoftwareUpdatePointComponent
Alterações não-quebrando
Adicione novo parâmetro contentFileOption para configurar o comportamento de descarregamento da atualização.
Set-CMSiteMaintenanceTask
Alterações não-quebrando
Improved error reporting (Relatórios de erros melhorados)
Set-CMWirelessProfile
Insetos que foram corrigidos
O Comandante não funciona num ambiente PowerShell de 64 bits.
Pode levantar-se um erro de nome de tipo de identificação desajustado quando utilizar o pipeline do objeto.
ProxyAddress e ProxyPort não valida usando as mesmas regras que a consola Desemprovadora Do Gestor de Configuração.
Especificar o ProxyAddress sem ProxyPort pode causar a criação de uma configuração inválida.
SecurityAufercation pode ser alterada com configurações que não suportam isto.
O EapType deve ser combinado com a Garantia de Segurança mesmo quando este não está a mudar.
Alterações não-quebrando
Adicionados RootCertificate, ClientCertificate e RememberCredentials parâmetros.
Funcionalidade melhorada para configurar uma política sem fios MSCHAPv2.
Sync-CMSoftwareUpdate
Alterações não-quebrando
O Comandante já não requer que sejam especificados parâmetros.
Nota
Quando não são definidos parâmetros, -ForceSync $true
está implícito.