Condividi tramite

Gestione configurazione della libreria di cmdlet per la versione 2103

  • Articolo

Si applica a: Configuration Manager (Current Branch)

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

Nota

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

Problema noto con la Guida di PowerShell aggiornabile

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

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

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

Il cmdlet scarica correttamente il contenuto in 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 della versione 2103, se è stato usato Update-Help con un sito della versione 2010, è possibile continuare a usare Get-Help ora.

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

Nota

Questo problema è univoco per la versione 2010. A causa della modifica della struttura, non dovrebbe essere un problema per le versioni successive.

Modulo PowerShell

Se la console di Configuration Manager nel dispositivo non è 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 ConfigurationManager PowerShell richiede Microsoft .NET versione 4.7.2 o successiva.

Cmdlet che non supportano PowerShell versione 7

Anche Gestione configurazione cmdlet forniscono 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 il .NET Framework invece di .NET Core usato con PowerShell versione 7.

A partire dalla versione 2103, se si tenta di usare questi cmdlet in una sessione di PowerShell versione 7, non riescono 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 deprecazione. Alcune modifiche potrebbero causare un'interruzione. Se si usa uno dei cmdlet o delle aree di funzionalità elencate in questa sezione, esaminare attentamente le modifiche per comprendere in che modo possono influire sull'uso.

Supporto rapido

I cmdlet seguenti supportano ora il parametro Fast. Usare questo parametro per non aggiornare automaticamente le proprietà lazy. Le proprietà lazy contengono valori relativamente inefficienti da recuperare. Il recupero di queste proprietà può causare un maggiore traffico di rete e influire sulle prestazioni dei 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 che non causano un'interruzione

Correzione di un nome di parametro incoerente.

Copy-CMCollection

Modifiche che non causano un'interruzione

Correzione della convalida con il parametro NewName per allinearsi alla console.

Get-CMDeploymentStatusDetails

Modifiche che non causano un'interruzione

  • Correzione del 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 di output modificando il tipo di oggetto di output SMS_AppDeploymentRequirementsNotMetStatus in SMS_AppDeploymentRequirementsNotMetAssetDetails.
  • Modifica del tipo di oggetto di output da SMS_AppDeploymentAssetDetails a SMS_AppDeploymentErrorAssetDetails per ottenere altri dettagli sull'errore.
  • Aggiunta di un tipo di oggetto di input SMS_UpdateDeploymentSummary in modo che questo cmdlet possa ottenere i dettagli di distribuzione degli aggiornamenti. Quando si passa l'output di Get-CMSoftwareUpdateDeploymentStatus a Get-CMDeploymentStatusDetails, restituisce i dettagli di distribuzione da SMS_SUMDeploymentAssetDetails.

Get-CMDriver

Modifiche che non causano un'interruzione

Aggiungere 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 che non causano un'interruzione

Aggiunta del parametro PackageType per il recupero di un tipo di pacchetto specifico.

Get-CMSoftwareUpdateDeployment

Modifiche che non causano un'interruzione

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

New-CMApplication

Bug corretti

Corretto un problema di visualizzazione di Software Center durante l'installazione di app create con il formato di data "aaaa/MM/gg".

New-CMCertificateProfileScep

Bug corretti

Corretto un problema per il parametro SanType.

New-CMCollection

Modifiche che non causano un'interruzione

Correzione della convalida con il parametro Name per allinearsi alla console.

New-CMOperatingSystemImage

Modifiche che non causano un'interruzione

Aggiunto il parametro Index. Quando si aggiunge questo parametro il sito estrae un'immagine a un solo indice da un'immagine con più indici. Inserisce quindi la nuova immagine nella stessa cartella di origine dell'immagine originale.

New-CMOperatingSystemInstaller

Modifiche che non causano un'interruzione

Aggiunto il parametro Index. Quando si aggiunge questo parametro il sito sostituisce l'attuale immagine con più indici con una nuova immagine a un solo indice.

New-CMTSRule

Modifiche che non causano un'interruzione

Il parametro ReferencedVariableOperator ha un altro valore possibile: NotLike .

New-CMTSStepConditionVariable

Modifiche che non causano un'interruzione

Il parametro OperatorType ha un altro valore possibile: NotLike

New-CMSoftwareUpdateAutoDeploymentRule

Modifiche di rilievo

Corretto un problema per il parametro O365LanguageSelection. È ora necessario specificare una lingua con un nome di paese. Questa modifica allinea il parametro alle opzioni della console di Configuration Manager. Ad esempio, usare -O365LanguageSelection "English (United States)"

Set-CMCertificateProfileScep

Bug corretti

Corretto un problema per il parametro SanType.

Set-CMClientPushInstallation

Modifiche che non causano un'interruzione

Aggiungere il parametro AllownNTLMFallback per abilitare il fallback NTLM.

Set-CMCollection

Modifiche che non causano un'interruzione

Correzione della convalida con il parametro NewName per allinearsi alla console.

Set-CMEmailProfile

Modifiche che non causano un'interruzione

  • Correzione del problema relativo al parametro NewName quando si specifica sAMAccountName come nome utente dell'account.
  • Correzione di un problema di parametro durante la risoluzione di DomainName.

Set-CMFallbackStatusPoint

Modifiche che non causano un'interruzione

Correzione di un nome di parametro incoerente.

Set-CMThirdPartyUpdateCatalog

Modifiche che non causano un'interruzione

Aggiungere i parametri CategoryNamePublishOption e CategoryIdPublishOption. Usare questi parametri per impostare l'opzione di pubblicazione della 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 che non causano un'interruzione

Risolto un problema con il parametro PublishOption impostato su FullContent .

Set-CMTSStep*

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

Modifiche che non causano un'interruzione

Il parametro OperatorType ha un altro valore possibile: NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

Modifiche di rilievo

Corretto un problema per il parametro O365LanguageSelection. È ora necessario specificare una lingua con un nome di paese. Questa modifica allinea il parametro alle opzioni della console di Configuration Manager. Ad esempio, usare -O365LanguageSelection "English (United States)"

Come inviare commenti e suggerimenti o segnalare problemi

Molte delle correzioni e dei miglioramenti descritti in questo articolo sono il risultato dei commenti e suggerimenti degli utenti.

Per inviare commenti e suggerimenti, usare Gestione configurazione console. Per altre informazioni, vedere Feedback per PowerShell.

Per inviare nuove richieste di funzionalità, vedere il gruppo powershell di Gestione configurazione in UserVoice.