Gestione configurazione della libreria di cmdlet per la versione 2107
Si applica a: Configuration Manager (Current Branch)
Queste note sulla versione riepilogano le modifiche apportate alla Gestione configurazione cmdlet nella versione 2107.
Nota
Gestione configurazione Current Branch versione 2103 è la baseline per queste modifiche. Per altre informazioni, vedere Gestione configurazione della libreria di cmdlet per la versione 2103.
Nuovi cmdlet per i tipi di distribuzione di app
Gestire i comportamenti di installazione per i tipi di distribuzione delle applicazioni
Questo set di nuovi cmdlet è per il comportamento di installazione del tipo di distribuzione dell'applicazione. Per informazioni più generali sulla funzionalità di comportamento di installazione, vedere Verificare la presenza di file eseguibili in esecuzione.
Add-CMDeploymentTypeInstallBehavior
Usare questo cmdlet per aggiungere al tipo di distribuzione specificato i file eseguibili da chiudere per l'installazione dell'app.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -DisplayName "Notepad"
Per altre informazioni, vedere Add-CMDeploymentTypeInstallBehavior.
Get-CMDeploymentTypeInstallBehavior
Usare questo cmdlet per ottenere dal tipo di distribuzione specificato l'elenco di file eseguibili da chiudere per l'installazione dell'app.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Get-CMDeploymentTypeInstallBehavior -InputObject $msi_dt
Per altre informazioni, vedere Get-CMDeploymentTypeInstallBehavior.
Remove-CMDeploymentTypeInstallBehavior
Usare questo cmdlet per rimuovere dal tipo di distribuzione specificato i file eseguibili da chiudere per l'installazione dell'app.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe"
Per altre informazioni, vedere Remove-CMDeploymentTypeInstallBehavior.
Set-CMDeploymentTypeInstallBehavior
Usare questo cmdlet per modificare i file eseguibili da chiudere perché l'installazione dell'app riesca.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Set-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -NewExeFileName "calc.exe" -DisplayName "Calculator"
Per altre informazioni, vedere Set-CMDeploymentTypeInstallBehavior.
Gestire i codici restituiti per i tipi di distribuzione dell'applicazione
Questo set di nuovi cmdlet è per i codici restituiti del tipo di distribuzione dell'applicazione. Per informazioni più generali, vedere Codici restituiti del tipo di distribuzione.
Add-CMDeploymentTypeReturnCode
Usare questo cmdlet per aggiungere codici restituiti a un tipo di distribuzione supportato.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602 -Name "User cancel" -CodeType Failure -Description "The user cancelled the installation"
Per altre informazioni, vedere Add-CMDeploymentTypeReturnCode.
Get-CMDeploymentTypeReturnCode
Usare questo cmdlet per ottenere l'elenco dei codici restituiti dal tipo di distribuzione specificato.
Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)" | Get-CMDeploymentTypeReturnCode
Per altre informazioni, vedere Get-CMDeploymentTypeReturnCode.
Remove-CMDeploymentTypeReturnCode
Usare questo cmdlet per eliminare i codici restituiti dal tipo di distribuzione specificato.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602
Per altre informazioni, vedere Remove-CMDeploymentTypeReturnCode.
Set-CMDeploymentTypeReturnCode
Usare questo cmdlet per modificare i codici restituiti per il tipo di distribuzione specificato.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 3010 -Name "Always reboot" -CodeType HardReboot -Description "Change soft reboot to hard reboot"
Per altre informazioni, vedere Set-CMDeploymentTypeReturnCode.
Altri nuovi cmdlet
Get-CMClientSettingDeployment
Usare questo cmdlet per ottenere una distribuzione di un oggetto impostazioni client personalizzato. È possibile usare questo oggetto con Remove-CMClientSettingDeployment.
Per altre informazioni sulle impostazioni client, vedere Come configurare le impostazioni client.
$clientSetting = Get-CMClientSetting -Name "Software Center customizations"
$clientSetting | Get-CMClientSettingDeployment
Per altre informazioni, vedere Get-CMClientSettingDeployment.
Get-CMDeploymentTypeDetectionClause
Usare questo cmdlet per ottenere le clausole di rilevamento dal tipo di distribuzione specificato.
È possibile usare questo cmdlet per ottenere una clausola di rilevamento da un'app e applicarla a un'altra, ad esempio:
$appMsi = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
$clause1 = Get-CMDeploymentTypeDetectionClause -InputObject $appMsi
Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause1
Per altre informazioni, vedere Get-CMDeploymentTypeDetectionClause.
Get-CMPersistentUserSettingsGroup
Usare questo cmdlet per ottenere l'elenco delle impostazioni a livello di sito archiviate. Queste impostazioni seguono l'utente in dispositivi diversi.
Ad esempio, Gestione configurazione di console attive o ignorate.
Per altre informazioni, vedere Get-CMPersistentUserSettingsGroup.
Get-CMSoftwareUpdateContentInfo
Usare questo cmdlet per ottenere informazioni sul contenuto dell'aggiornamento software.
$update = Get-CMSoftwareUpdate -ArticleId "5004237" -Fast
Get-CMSoftwareUpdateContentInfo -InputObject $update[1]
Per altre informazioni, vedere Get-CMSoftwareUpdateContentInfo.
Remove-CMPersistentUserSettingsGroup
Usare questo cmdlet per reimpostare le impostazioni a livello di sito.
Ad esempio, è possibile Gestione configurazione le notifiche della console ignorate. Dopo aver eseguito questo cmdlet e aver riavviato la console Gestione configurazione, verranno nuovamente visualizzati tutti i messaggi di notifica disponibili.
Per altre informazioni, vedere Remove-CMPersistentUserSettingsGroup.
Cmdlet deprecati e rimossi
I cmdlet seguenti per avviare una distribuzione sono deprecati e potrebbero essere rimossi in una versione futura:
| Cmdlet deprecato | Sostituzione |
|---|---|
| Start-CMApplicationDeploymentSimulation | New-CMApplicationDeployment con il parametro Simulation |
| Start-CMClientSettingDeployment | New-CMClientSettingDeployment |
| Start-CMAntimalwarePolicyDeployment | New-CMAntimalwarePolicyDeployment |
I cmdlet seguenti non sono più disponibili perché le funzionalità sottostanti non sono più supportate:
Add-CMApplicationCatalogWebServicePoint
Add-CMApplicationCatalogWebsitePoint
Get-CMApplicationCatalogWebServicePoint
Get-CMApplicationCatalogWebsitePoint
Remove-CMApplicationCatalogWebServicePoint
Remove-CMApplicationCatalogWebsitePoint
Set-CMApplicationCatalogWebsitePoint
Get-CMVhd
New-CMVhd
Remove-CMVhd
Set-CMVhd
Modifiche dei cmdlet
In questa versione sono state apportate le modifiche seguenti ai cmdlet esistenti. Le modifiche possono essere nuove funzionalità o correzioni di bug. Alcune modifiche potrebbero essere di rilievo. 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.
Add-CMDeviceCollectionDirectMembershipRule
Per altre informazioni, vedere Add-CMDeviceCollectionDirectMembershipRule.
Bug corretti
È stato risolto un problema durante il tentativo di aggiungere migliaia di dispositivi come regole di appartenenza diretta.
Add-CMDistributionPoint
Per altre informazioni, vedere Add-CMDistributionPoint.
Modifiche di rilievo
Lo spazio disponibile minimo predefinito è stato modificato da 50 MB a 500 MB.
Add-CMTaskSequenceStep
Per altre informazioni, vedere Add-CMTaskSequenceStep.
Modifiche che non causano un'interruzione
Rimozione del parametro non necessario StepName.
Disconnect-CMTrackedObject
Per altre informazioni, vedere Disconnect-CMTrackedObject.
Modifiche che non causano un'interruzione
Aggiunta dell'alias Disconnect-CMObject per questo cmdlet.
Get-CMApplicationGroup
Per altre informazioni, vedere Get-CMApplicationGroup.
Bug corretti
Risolto un problema per ottenere il percorso del gruppo di app corretto.
Get-CMDeploymentStatusDetails
Per altre informazioni, vedere Get-CMDeploymentStatusDetails.
Bug corretti
Correzione della condizione di query per evitare potenziali problemi di mancata corrispondenza del tipo.
Import-CMAntimalwarePolicy
Per altre informazioni, vedere Import-CMAntimalwarePolicy.
Modifiche che non causano un'interruzione
Aggiunta del supporto per i criteri della modalità di controllo con applicazioni potenzialmente indesiderate. Per altre informazioni, vedere Modalità di controllo per applicazioni potenzialmente indesiderate.
Import-CMQuery
Per altre informazioni, vedere Import-CMQuery.
Bug corretti
Risolto un problema per sbloccare la funzione di importazione.
New-CMAdministrativeUser
Per altre informazioni, vedere New-CMAdministrativeUser.
Bug corretti
Correzione di un problema quando il nome utente è me .
New-CMApplicationDeployment
Per altre informazioni, vedere New-CMApplicationDeployment.
Modifiche che non causano un'interruzione
Aggiunta del parametro AutoCloseExecutable per abilitare l'impostazione di distribuzione dell'applicazione per i comportamenti di installazione.
New-CMCloudManagementGateway
Per altre informazioni, vedere New-CMCloudManagementGateway.
Modifiche di rilievo
Il parametro ServiceCertPassword è ora obbligatorio.
New-CMMigrationJob
Per altre informazioni, vedere New-CMMigrationJob.
Bug corretti
È stata sbloccata la migrazione degli oggetti di distribuzione software.
New-CMSecondarySite
Per altre informazioni, vedere New-CMSecondarySite.
Modifiche di rilievo
Modifica dello spazio libero minimo predefinito da 200 MB a 500 MB.
New-CMSoftwareUpdateAutoDeploymentRule
Per altre informazioni, vedere New-CMSoftwareUpdateAutoDeploymentRule.
Bug corretti
Correzione di un problema con il parametro Product. Quando sono presenti più prodotti con lo stesso nome, vengono selezionati tutti.
New-CMSoftwareUpdateDeployment
Per altre informazioni, vedere New-CMSoftwareUpdateDeployment.
Modifiche che non causano un'interruzione
Aggiunta dell'alias Description al parametro Comment.
New-CMTaskSequence
Per altre informazioni, vedere New-CMTaskSequence.
Modifiche che non causano un'interruzione
Estensione della lunghezza massima del parametro Description ai
512caratteri.Aggiunta del nuovo parametro HighPerformance per supportare l'impostazione delle prestazioni.
Il parametro InstallationLicensingMode legacy è stato rimosso.
Rimozione del set di parametri NewInstallOSImageVhd.
Rimozione del parametro InstallOperatingSystemImageVhd.
New-CMTaskSequenceDeployment
Per altre informazioni, vedere New-CMTaskSequenceDeployment.
Bug corretti
Correzione di un problema relativo alle combinazioni per il risparmio di energia ad alte prestazioni.
New-CMTSStepApplyDriverPackage
Per altre informazioni, vedere New-CMTSStepApplyDriverPackage.
Modifiche che non causano un'interruzione
Aggiunta di una condizione per convalidare un pacchetto per il packageId specificato.
New-CMTSStepApplyOperatingSystem
Per altre informazioni, vedere New-CMTSStepApplyOperatingSystem.
Bug corretti
Sono stati risolti problemi di convalida con il parametro DestinationVariable per consentire valori che iniziano con un carattere di sottolineatura ( _ ).
Modifiche che non causano un'interruzione
Aggiunta del parametro LayeredDriver per supportare il driver della tastiera a più livelli durante la distribuzione del sistema operativo.
New-CMTSStepUpgradeOperatingSystem
Per altre informazioni, vedere New-CMTSStepUpgradeOperatingSystem.
Modifiche che non causano un'interruzione
Aggiunta del nuovo parametro SoftwareUpdate per specificare un aggiornamento delle funzionalità per il passaggio Aggiorna sistema operativo della sequenza di attività.
Publish-CMPrestageContent
Per altre informazioni, vedere Publish-CMPrestageContent.
Bug corretti
È stato risolto un potenziale problema di oggetto non valido.
Remove-CMApplicationGroup
Per altre informazioni, vedere Remove-CMApplicationGroup.
Bug corretti
Risolto un problema per ottenere il percorso del gruppo di app corretto quando si usa la pipeline.
Set-CMAntimalwarePolicy
Per altre informazioni, vedere Set-CMAntimalwarePolicy.
Modifiche che non causano un'interruzione
Aggiunta del parametro PuaProtection per supportare applicazioni potenzialmente indesiderate.
Set-CMApplicationDeployment
Per altre informazioni, vedere Set-CMApplicationDeployment.
Modifiche che non causano un'interruzione
Aggiunta del parametro AutoCloseExecutable per abilitare l'impostazione di distribuzione dell'applicazione per i comportamenti di installazione.
Set-CMClientSetting
Per altre informazioni, vedere Set-CMClientSetting.
Modifiche che non causano un'interruzione
Aggiunta di un messaggio di deprecazione significativo per il parametro SoftwareMetering.
Set-CMClientSettingSoftwareUpdate
Per altre informazioni, vedere Set-CMClientSettingSoftwareUpdate.
Modifiche che non causano un'interruzione
Aggiunta del parametro EnableWsusCertPinning per supportare l'aggiunta di certificati.
Set-CMDeploymentType
Per altre informazioni, vedere Set-CMDeploymentType.
Bug corretti
Correzione di un problema relativo al parametro AddRequirement per l'aggiunta di nuove regole.
Set-CMMsiDeploymentType
Per altre informazioni, vedere Set-CMMsiDeploymentType.
Bug corretti
Aggiornare il tipo di distribuzione in base al tipo di programma di installazione per evitare di reimpostare le configurazioni quando si modifica il percorso del contenuto.
Modifiche che non causano un'interruzione
Aggiunta del supporto per specificare un percorso di cartella per il parametro ContentLocation.
Set-CMTaskSequence
Per altre informazioni, vedere Set-CMTaskSequence.
Modifiche che non causano un'interruzione
Aggiunta del nuovo parametro HighPerformance per supportare l'impostazione delle prestazioni per la sequenza di attività.
Set-CMTSStepApplyDriverPackage
Per altre informazioni, vedere Set-CMTSStepApplyDriverPackage.
Modifiche che non causano un'interruzione
Aggiunta di una condizione per convalidare un pacchetto per il packageId specificato.
Set-CMTSStepApplyOperatingSystem
Per altre informazioni, vedere Set-CMTSStepApplyOperatingSystem.
Bug corretti
Correzione di un problema con il parametro Destination.
Modifiche che non causano un'interruzione
Aggiunta del parametro LayeredDriver per supportare il driver della tastiera a più livelli durante la distribuzione del sistema operativo.
Set-CMTSStepUpgradeOperatingSystem
Per altre informazioni, vedere Set-CMTSStepUpgradeOperatingSystem.
Modifiche che non causano un'interruzione
Aggiunta del nuovo parametro SoftwareUpdate per specificare un aggiornamento delle funzionalità per il passaggio Aggiorna sistema operativo della sequenza di attività.
Start-CMDistributionPointUpgrade
Per altre informazioni, vedere Start-CMDistributionPointUpgrade.
Modifiche di rilievo
Impostare lo spazio libero minimo predefinito su 500 MB.
Update-CMDistributionPoint
Per altre informazioni, vedere Update-CMDistributionPoint.
Bug corretti
Risolto un problema per aggiornare il contenuto dalle cartelle di installazione e disinstallazione quando sono diverse.
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.