Modifiche alla libreria di cmdlet di Gestione configurazione per la versione 2103

Si applica a: Gestione configurazione (Current Branch)

Queste note sulla versione riepilogano le modifiche apportate alla libreria di cmdlet di Gestione configurazione nella versione 2103.

Nota

Gestione configurazione Current Branch versione 2010 è la base per queste modifiche. Per altre informazioni, vedere Modifiche alla libreria di cmdlet di Gestione configurazione per la versione 2010.

Problema noto con la Guida di PowerShell aggiornabile

A partire dalla versione 2010, puoi usare il cmdlet Update-Help per scaricare le informazioni più recenti per il modulo PowerShell di Gestione configurazione.

Nella versione 2103, la struttura del modulo PowerShell è cambiata da 29 DLL a due. I file della Guida XML di PowerShell sono associati alla DLL per i cmdlet. Pertanto, il contenuto della Guida della versione 2010 non è compatibile con una console della versione 2103 e il contenuto della Guida della versione 2103 è incompatibile con una console della versione 2010.

A causa di questa modifica nella struttura e nella pubblicazione del contenuto aggiornabile con il rilascio della versione 2103, non usare la Guida di aggiornamento in un sito della versione 2010. Aggiornare il sito alla versione 2103 e quindi aggiornare il contenuto della Guida locale.

Il cmdlet scaricherà correttamente il contenuto su una console della versione 2010, ma Get-Help restituirà solo le informazioni sull'utilizzo predefinite. Questo comportamento è dovuto al fatto che PowerShell non è in grado di trovare le informazioni sui cmdlet nel file XML corretto, che ora è diverso. Prima del rilascio della versione 2103, se si usava Update-Help con un sito della versione 2010, è possibile continuare a usare Get-Help ora.

Analogamente, se è stato utilizzato Update-Help in un sito della versione 2010, dopo aver eseguito l'aggiornamento alla versione 2103, eseguire nuovamente Update-Help per ottenere la versione compatibile del contenuto della Guida. In caso contrario, Get-Help restituirà solo le informazioni sull'utilizzo predefinito.

Nota

Questo problema è unico per la versione 2010. A causa di come è cambiata la struttura, non dovrebbe essere un problema per le versioni successive.

Modulo PowerShell

Se la console di Gestione configurazione nel dispositivo non si è già connessa a un sito, se si importa manualmente il modulo ConfigurationManager, viene creata un'unità PowerShell per il sito basata sul provider SMS predefinito.

A partire dalla versione 2103, il modulo PowerShell ConfigurationManager richiede Microsoft .NET versione 4.7.2 o successiva.

Cmdlet che non supportano PowerShell versione 7

Sebbene i cmdlet di Gestione configurazione forniscano supporto generale per PowerShell versione 7, i cmdlet seguenti non supportano PowerShell 7:

  • Import-CMPackage
  • Import-CMDriverPackage
  • Import-CMTaskSequence
  • Export-CMPackage
  • Export-CMDriverPackage
  • Export-CMTaskSequence

Richiedono .NET Framework invece di .NET Core che è usato con PowerShell versione 7.

A partire dalla versione 2103, se si tenta di usare questi cmdlet in una sessione di PowerShell versione 7, l'operazione non riesce con l'errore seguente: This cmdlet only supports the ".NET Framework" runtime.

Nuovi cmdlet

Modifiche dei cmdlet

In questa versione sono state apportate le modifiche seguenti ai cmdlet esistenti. Le modifiche possono essere nuove funzionalità, correzioni di bug o deprecazioni. Alcuni cambiamenti potrebbero interrompersi. Se si usa uno dei cmdlet o delle aree di funzionalità elencati in questa sezione, esaminare attentamente le modifiche per comprendere in che modo potrebbero influire sull'uso.

Supporto rapido

I cmdlet seguenti supportano ora il parametro Fast . Usare questo parametro per non aggiornare automaticamente le proprietà differite. Le proprietà pigre contengono valori relativamente inefficienti da recuperare. L'ottenimento di queste proprietà può causare più traffico di rete e influire sulle prestazioni del cmdlet.

  • Get-CMAlert
  • Get-CMAlertSubscription
  • Get-CMBaseline
  • Get-CMBaselineDeployment
  • Get-CMBaselineDeploymentStatus
  • Get-CMClientCertificatePfx
  • Get-CMComplianceRule
  • Get-CMComplianceSetting
  • Get-CMConfigurationPlatform
  • Get-CMConfigurationPolicyDeployment
  • Get-CMDriver
  • Get-CMDriverPackage
  • Get-CMTaskSequence
  • Get-CMTaskSequenceDeployment

Add-CMFallbackStatusPoint

Modifiche non significative

È stato corretto un nome di parametro incoerente.

Copy-CMCollection

Modifiche non significative

È stata corretta la convalida con il parametro NewName per allinearlo alla console.

Get-CMDeploymentStatusDetails

Modifiche non significative

  • È stato risolto un problema di convalida del tipo di oggetto di input per tipi come SMS_DCMDeploymentErrorStatus, SMS_DCMDeploymentNonCompliantStatus e SMS_DCMDeploymentCompliantStatus.
  • Risolto il problema del tipo di classe non valido dell'output modificando il tipo di oggetto di output SMS_AppDeploymentRequirementsNotMetStatus a SMS_AppDeploymentRequirementsNotMetAssetDetails.
  • È stato modificato il tipo di oggetto di output da SMS_AppDeploymentAssetDetails a SMS_AppDeploymentErrorAssetDetails per ottenere maggiori dettagli sull'errore.
  • Aggiunta di un tipo di oggetto di input SMS_UpdateDeploymentSummary modo che questo cmdlet possa ottenere i dettagli sulla distribuzione degli aggiornamenti. Quando si passa l'output di Get-CMSoftwareUpdateDeploymentStatus a Get-CMDeploymentStatusDetails, restituisce i dettagli della distribuzione da SMS_SUMDeploymentAssetDetails.

Get-CMDriver

Modifiche non significative

Aggiunta la possibilità di filtrare in base al parametro AdministrativeCategory.

$category1 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 1'
$category2 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 2'
$categories = $category1,$category2

Get-CMDriver -AdministrativeCategory $categories

Get-CMPackage

Modifiche non significative

Aggiunto il parametro PackageType per recuperare un tipo di pacchetto specifico.

Get-CMSoftwareUpdateDeployment

Modifiche non significative

È stato risolto un problema durante la distribuzione degli aggiornamenti senza pacchetto.

New-CMApplication

Bug che sono stati risolti

È stato risolto un problema di visualizzazione di Software Center durante l'installazione di app create con il formato ora "gg/MM/aaaa".

New-CMCertificateProfileScep

Bug che sono stati risolti

È stato risolto un problema per il parametro SanType.

New-CMCollection

Modifiche non significative

È stata corretta la convalida con il parametro Nome per allinearsi alla console.

New-CMOperatingSystemImage

Modifiche non significative

Aggiunto il parametro Indice. Quando si aggiunge questo parametro, il sito estrae una singola immagine indice da un'immagine multi-indice. La nuova immagine viene quindi inserita nella stessa cartella di origine dell'immagine originale.

New-CMOperatingSystemInstaller

Modifiche non significative

Aggiunto il parametro Indice. Quando si aggiunge questo parametro, il sito sostituisce l'immagine multi-indice corrente con una nuova immagine a indice singolo.

New-CMTSRule

Modifiche non significative

Il parametro ReferencedVariableOperator ha un altro valore possibile: NotLike.

New-CMTSStepConditionVariable

Modifiche non significative

Il parametro OperatorType ha un altro valore possibile: NotLike

New-CMSoftwareUpdateAutoDeploymentRule

Modifiche di rilievo

È stato risolto un problema relativo al parametro O365LanguageSelection. A questo punto è necessario specificare una lingua con il nome di un paese/area geografica. Questa modifica allinea questo parametro alle opzioni nella console di Gestione configurazione. Ad esempio, -O365LanguageSelection "English (Stati Uniti)"

Set-CMCertificateProfileScep

Bug che sono stati risolti

È stato risolto un problema per il parametro SanType.

Set-CMClientPushInstallation

Modifiche non significative

Aggiungere il parametro AllownNTLMFallback per abilitare il fallback NTLM.

Set-CMCollection

Modifiche non significative

È stata corretta la convalida con il parametro NewName per allinearlo alla console.

Set-CMEmailProfile

Modifiche non significative

  • È stato risolto un problema con il parametro NewName quando si specificava sAMAccountName come nome utente dell'account.
  • È stato risolto un problema di parametro durante la risoluzione di DomainName.

Set-CMFallbackStatusPoint

Modifiche non significative

È stato corretto un nome di parametro incoerente.

Set-CMThirdPartyUpdateCatalog

Modifiche non significative

Aggiungere i parametri CategoryNamePublishOption e CategoryIdPublishOption. Usare questi parametri per impostare l'opzione di pubblicazione per categoria quando si sottoscrive un catalogo v3.

$id = "5768207d-6c40-465b-ad65-50501661368f"
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$idOptionPair = @{$id = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName 'pmp' -CategoryIdPublishOption $idOptionPair -Subscribe -Force

$name = "2BrightSparks"
$name1 = "8x8, Inc."
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$nameOptionPair = @{$name = $option; $name1 = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName pmp -CategoryNamePublishOption $nameOptionPair -Subscribe -Force

Set-CMThirdPartyUpdateCategory

Modifiche non significative

È stato risolto un problema con il parametro PublishOption impostato su FullContent.

Set-CMTSStep*

Ad esempio, Set-CMTSStepApplyDataImage e gli altri 34 cmdlet simili.

Modifiche non significative

Il parametro OperatorType ha un altro valore possibile: NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

Modifiche di rilievo

È stato risolto un problema relativo al parametro O365LanguageSelection. A questo punto è necessario specificare una lingua con il nome di un paese. Questa modifica allinea questo parametro alle opzioni nella console di Gestione configurazione. Ad esempio, -O365LanguageSelection "English (Stati Uniti)"

Come fornire feedback o segnalare problemi

Molti degli aggiornamenti e dei miglioramenti descritti in questo articolo sono il risultato del feedback degli utenti.

Per inviare feedback, usa la console di Gestione configurazione. Per altre informazioni, vedere Feedback per PowerShell.

  • Last updated on