Condividi tramite

Configuration Manager modifiche alla libreria dei cmdlet per la versione 1902

  • Articolo

Si applica a: Configuration Manager (Current Branch)

Nota

Configuration Manager current branch versione 1810 è la linea di base per queste modifiche. Per altre informazioni, vedere Configuration Manager modifiche alla libreria di cmdlet per la versione 1810.

Modifiche importanti

Nuovi cmdlet

Get-CMBoundaryGroupSiteSystem

Usare questo cmdlet per ottenere il sistema del sito nel gruppo di limiti specificato.

Get-CMBoundaryGroupSiteSystem -Id $boundaryGroup.GroupID

Get-CMDistributionPointDriveInfo

Usare questo cmdlet per ottenere informazioni sull'unità del punto di distribuzione.

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

Invoke-CMAnalyzePackage

Usare questo cmdlet per analizzare un pacchetto specifico.

Invoke-CMAnalyzePackage -PackageName $packageName

Invoke-CMConvertPackage

Usare questo cmdlet per convertire un pacchetto specifico in un'applicazione.

Invoke-CMConvertPackage -PackageName $packageName

New-CMScript

Usare questo cmdlet per creare un nuovo script di PowerShell. Supporta solo script che non contengono parametri.

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

Set-CMClientSettingDeliveryOptimization

Usare questo cmdlet per impostare le impostazioni client per la funzionalità Ottimizzazione recapito.

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

Set-CMClientSettingWindowsAnalytics

Usare questo cmdlet per impostare le impostazioni client per la funzionalità di 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

Cmdlet rimossi

Nessuno

Cmdlet deprecati

Nessuno

Problemi noti

Gli elementi seguenti sono problemi noti relativi alla libreria di cmdlet che non vengono risolti in questa versione.

Get-CMAadConditionalAccessPolicy e Set-CMAadConditionalAccessPolicy

Questi cmdlet richiedono un ambiente PowerShell a 64 bit.

Soluzione alternativa

  • Nessuno

Import-CMSecurityRole

Il cmdlet potrebbe non riuscire con un errore DirectoryNotFoundException durante l'individuazione del file SecuredRoles.xsd.

Soluzione alternativa

  • Chiamare Import-Module sul ConfigurationManager.psd1 file e non sul percorso logico o sul nome del modulo.

Set-CMSoftwareUpdatePoint

Le modifiche apportate a Pianificazione potrebbero non essere visualizzate nella console di Configuration Manager anche se l'oggetto provider SMS sottostante è stato modificato.

Soluzione alternativa

  • Chiudere e riavviare la console Configuration Manager.

Rilevamento e ripristino delle risorse (beta)

Questa versione aggiunge nuovi cmdlet per supportare il rilevamento degli oggetti provider SMS usati dal runtime di PowerShell e per pulire queste risorse quando non sono più necessarie.

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

Quando si esegue Start-CMObjectTracking, il runtime di PowerShell tiene traccia degli IResultObject oggetti creati dai cmdlet della libreria di cmdlet. Per i cmdlet che non vengono puliti manualmente con .Dispose(), recuperarli usando Disconnect-CMTrackedObject su un singolo oggetto.

Esempio

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

# Reclaim all tracked objects
Disconnect-CMTrackedObject -All

Una volta recuperato, un oggetto non può più essere riutilizzato o passato a un altro cmdlet tramite la pipeline dell'oggetto.

Stop-CMObjectTracking può essere usato per disattivare il rilevamento degli oggetti. Gli oggetti allocati in precedenza rimangono attivi.

Le risorse non reclamate possono causare errori di violazione della quota da parte del provider SMS. Questi problemi di quota si manifestano in genere dall'uso di set di grandi dimensioni di oggetti provider SMS o in ambienti a esecuzione prolungata.

Nota

Questa funzionalità è sperimentale e può essere soggetta a modifiche o rimozione in una versione futura. Si tratta del consenso esplicito e non è abilitato per impostazione predefinita.

Modifiche ai 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 una delle aree dei cmdlet o delle funzionalità elencate in questa sezione, esaminare attentamente le modifiche per comprendere in che modo possono influire sull'uso.

Add-CMDeviceAffinityToUser

Bug corretti

  • Add/Remove-CMDeviceAffinityToUser -UserId/-UserName deve usare "-DeviceId/-DeviceName" insieme.

Modifiche non di rilievo

  • Aggiunta del controllo dei parametri per -DeviceID e -DeviceName. L'utente deve specificarne almeno uno.

Add-CMDeviceCollectionDirectMembershipRule

Bug corretti

  • Quando la stessa risorsa viene aggiunta alla stessa raccolta usando il comando 'Add-CMDeviceCollectionDirectMembershipRule' in PowerShell, viene visualizzato un avviso vuoto "AVVISO: " e non restituisce l'errore "Esiste già un oggetto con il nome specificato".

Modifiche non di rilievo

  • Aggiunta di una risorsa mancante.

Add-CMDistributionPoint

Modifiche non di rilievo

  • Aggiunta del parametro "-EnableLedbat" per abilitare/disabilitare LEDBAT in DP

Add-CMScriptDeploymentType

Bug corretti

  • Add-CMScriptDeploymentType non allineati all'interfaccia utente per impostazione predefinita

Modifiche non di rilievo

  • Modifica del codice di inizializzazione per l'allineamento con l'interfaccia utente (Tempo di installazione stimato = 0, requisito di accesso= solo quando un utente è connesso).

Approve-CMApprovalRequest

Modifiche non di rilievo

  • Aggiunto il nuovo parametro InstallActionBehavior (ha due opzioni: InstallNow, InstallNonBusinessHours), l'amministratore può specificare se installare l'applicazione immediatamente dopo l'approvazione o l'installazione durante gli orari non lavorativi. È un parametro facoltativo e per impostazione predefinita è uguale a "InstallNow".

Get-CMDevice

Bug corretti

  • Get-CMDevice manca la proprietà SMSAssignedSites, disponibile prima della 1806.

Modifiche non di rilievo

  • Sono stati aggiunti due nuovi parametri switch per consentire al cliente di specificare la classe dell'output:

    • -ReturnCollectionMember: forza l'istanza restituita della classe membro della raccolta sms
    • -ReturnResource: forza l'istanza restituita di SMS_Resource classe.

    Se usi il parametro predefinito senza ReturnCollectionMember/ReturnResource, il comportamento sarà uguale a 1802/1810: l'istanza restituita potrebbe trovarsi in classi diverse con parametri specificati diversi.

Get-CMPackage

Bug corretti

  • Get-CMPackage necessita di un commutatore -Fast

Modifiche non di rilievo

  • Aggiunta del parametro -Fast per supportare query veloci.

Import-CMDriver

Bug corretti

  • Set-CMDriver -SupportedPlatformName avrà esito negativo per le matrici

Modifiche non di rilievo

  • Correzione del problema relativo al valore della matrice per il parametro SupportPlatformName.

Invoke-CMScript

Bug corretti

  • Invoke-CMScript cmdlet prevede un oggetto che non può essere ottenuto.

Modifiche non di rilievo

  • Correzione della convalida del tipo.

New-CMActiveDirectoryForest

Bug corretti

  • Creazione della foresta di Active Directory: l'utente non funziona tramite PowerShell, solo se viene creata tramite l'interfaccia utente grafica.

Modifiche non di rilievo

  • L'account è stato importato nell'account globale dopo che l'utente ha impostato le credenziali.
  • Aggiunta del nuovo parametro -Password per la creazione di credenziali con password.

New-CMApplication

Bug corretti

  • L'utente non può specificare un parametro Owner o SupportContact vuoto con il cmdlet New-CMApplication

Modifiche non di rilievo

  • Consenti $null per Owner/SupportContact durante la creazione di una nuova applicazione, il valore predefinito sarà l'utente corrente.
  • Sono stati aggiunti nuovi parametri per Owner/SupportContact per supportare l'input della matrice.

New-CMApplicationDeployment

Modifiche non di rilievo

  • Aggiunto il nuovo parametro ReplaceToastNotificationWithDialog (Boolean), l'amministratore può specificare se sostituire le notifiche di tipo avviso popup con la finestra di dialogo quando il software necessario diventa disponibile nel computer client. È un parametro facoltativo e false per impostazione predefinita.

New-CMCoManagementPolicy

Modifiche non di rilievo

  • Aggiunta del supporto per i nuovi carichi di lavoro (DCWorkloadEnabled, O365WorkloadEnabled, ClientAppsWorkloadEnabled).

New-CMDetectionClauseWindowsInstaller

Bug corretti

  • Add/Set-CMMsiDeploymentType -AddDetectionClause non riuscito "Espressione non valida: il tipo di dati dell'operando non corrisponde o l'operatore non è valido per il tipo di dati".

Modifiche non di rilievo

  • È stata modificata la logica dell'inizializzazione del tipo di dati per assicurarsi che sia corretta quando si specifica l'opzione Esistenza.

New-CMOperatingSystemImageUpdateSchedule

Modifiche non di rilievo

  • Nuovo parametro aggiunto in base alle modifiche apportate alla creazione guidata pianificazione nell'interfaccia utente:
    • -RemoveSupersededUpdates

New-CMOperatingSystemUpgradeUpdateSchedule

Modifiche non di rilievo

  • Nuovo parametro aggiunto in base alle modifiche apportate alla creazione guidata pianificazione nell'interfaccia utente:
    • -RemoveSupersededUpdates

New-CMPackageDeployment

Bug corretti

  • New-CMPackageDeployment contiene avvisi incoerenti

Modifiche non di rilievo

  • Modifica del comportamento predefinito dell'opzione SlowNetwork per l'allineamento con l'interfaccia utente.

New-CMStatusFilterRule

Bug corretti

  • New-CMStatusFilterRule non funziona come previsto
  • Impossibile creare una nuova regola di filtro dello stato con la proprietà "ID pacchetto.

Modifiche non di rilievo

  • Aggiunta di altre condizioni per il controllo dell'ID/valore della proprietà per sbloccare il case senza -PropertyID specificato.
  • Aggiunta della logica per consentire l'ID proprietà del set di utenti = 'ID pacchetto' quando l'origine è 'Client'.

New-CMTaskSequenceDeployment

Bug corretti

  • Impossibile impostare l'ora di scadenza di una distribuzione della sequenza di attività
  • New-CMTaskSequenceDeployment , $result non è possibile ottenere l'oggetto da questo cmdlet.

Modifiche non di rilievo

  • Aggiunta dell'alias "DeploymentExpireDateTime" al parametro -DeadlineDateTime per l'allineamento con il cmdlet Set-.
  • Rimosso il blocco using, l'oggetto di distribuzione non deve essere eliminato.

New-CMTaskSequenceMedia

Modifiche non di rilievo

  • Nuovo parametro aggiunto per corrispondere alle modifiche aggiunte all'interfaccia utente di creazione del supporto della sequenza di attività:
    • -TemporaryFolder (alias "TemporaryDirectory", "StagingArea")

New-CMTSStepRunPowerShellScript

Modifiche di rilievo

  • Set di parametri aggiunti: RunScriptFromSource, RunScriptFromPackage.
  • I parametri PackageID e PackageName non sono più obbligatori perché gli utenti possono in alternativa immettere il nuovo parametro SourceScript

Modifiche non di rilievo

  • Nuovi parametri aggiunti per corrispondere alle modifiche apportate al passaggio Esegui script di Power Shell nell'interfaccia utente dell'editor della sequenza di attività:
    • -Sourcecode
    • -Workingdirectory
    • -OutputVariableName
    • -Timeout
    • -Nome utente
    • -Password
    • -SuccessCodes

Remove-CMDeviceAffinityFromUser

Bug corretti

  • Add/Remove-CMDeviceAffinityToUser -UserId/-UserName deve usare "-DeviceId/-DeviceName" insieme.

Modifiche non di rilievo

  • Aggiunta del controllo dei parametri per -DeviceID e -DeviceName. L'utente deve specificarne almeno uno.

Set-CMActiveDirectoryForest

Bug corretti

  • Creazione della foresta di Active Directory: l'utente non funziona tramite PowerShell, solo se viene creata tramite l'interfaccia utente grafica.

Modifiche non di rilievo

  • L'account è stato importato nell'account globale dopo che l'utente ha impostato le credenziali.
  • Aggiunta del nuovo parametro -Password per la creazione di credenziali con password.

Set-CMApplicationDeployment

Modifiche non di rilievo

  • Aggiunto il nuovo parametro ReplaceToastNotificationWithDialog (Boolean), l'amministratore può specificare se sostituire le notifiche di tipo avviso popup con la finestra di dialogo quando il software necessario diventa disponibile nel computer client. È un parametro facoltativo e false per impostazione predefinita.

Set-CMClientSetting

Modifiche non di rilievo

  • Aggiunto il nuovo parametro ReplaceToastNotificationWithDialog (Boolean), l'amministratore può specificare se sostituire le notifiche di tipo avviso popup con la finestra di dialogo quando il computer richiede il riavvio. È un parametro facoltativo e false per impostazione predefinita.

Set-CMClientSettingComputerRestart

Modifiche non di rilievo

  • Aggiunto il nuovo parametro ReplaceToastNotificationWithDialog (Boolean), l'amministratore può specificare se sostituire le notifiche di tipo avviso popup con la finestra di dialogo quando il computer richiede il riavvio. È un parametro facoltativo e false per impostazione predefinita.

Set-CMComplianceRuleExistential

Bug corretti

  • Set-CMComplianceRuleExistential -Rule non funziona per impostare il valore della regola.
  • Set-CMComplianceRuleExistential -ExpectedValue non consentono l'impostazione su un numero negativo, senza il parametro select [-Existence Occurs] impostato correttamente.

Modifiche non di rilievo

  • Modifica della funzione WarnIgnoredParameter per assicurarsi che chiami IsBoundParameterUsed con il parametro silent='true' per evitare errori di blocco quando il cmdlet figlio esegue l'override del parametro di base come parametro non pubblico.
  • La convalida per il risultato previsto è stata spostata in una posizione comune.

Set-CMDiscoveryMethod

Bug corretti

  • Set-CMDiscoveryMethod non dispone di un parametro per configurare l'account di individuazione.

Modifiche non di rilievo

  • Aggiunta del nuovo parametro -UserName per specificare l'account di individuazione per la nuova aggiunta di ADContainer per AD System/User Discovery.

Set-CMDistributionPoint

Modifiche non di rilievo

  • Aggiunta del parametro "-EnableLedbat" per abilitare/disabilitare LEDBAT in DP

Set-CMDriver

Bug corretti

  • Set-CMDriver -SupportedPlatformName avrà esito negativo per le matrici

Modifiche non di rilievo

  • Correzione del problema relativo al valore della matrice per il parametro SupportPlatformName.
  • Sono stati aggiunti nuovi parametri per SupportedPlatform: -AddSupportedPlatformName; -RemoveSupportedPlatformName; -ClearSupportedPlatform

Deprecazioni

  • Parametro deprecato: -SupportedPlatformName

Set-CMManagementPoint

Modifiche di rilievo

  • Modifica della convalida dei parametri per l'allineamento con l'interfaccia utente, aggiunta del codice per reimpostare il tipo di connessione client quando si abilita/disabilita il gateway cloud. Si tratta di una modifica che causa un'interruzione perché impedirebbe all'utente di abilitare il gateway cloud (-EnableCloudGateway) senza SSL.

Bug corretti

  • Set-CMManagementPoint -EnableCloudGateway, in un primo momento impostare MP come HTTPS/EnableCloudGateway true, quindi impostare MP su HTTP il EnableCloudGateway non deve essere controllato.

Set-CMStatusFilterRule

Bug corretti

  • Set-CMStatusFilterRule non funziona con l'impostazione dell'ID pacchetto

Modifiche non di rilievo

  • Consenti all'utente di impostare nuovamente la proprietà senza specificare di nuovo l'origine, il diverso con l'interfaccia utente è che è necessario che l'utente specifichi -PropertyID e -PropertyValue insieme.
  • Aggiunta di codice per evitare un messaggio di avviso vuoto quando l'oggetto non esiste.

Set-CMTSStepRunPowerShellScript

Modifiche non di rilievo

  • Nuovi parametri aggiunti per corrispondere alle modifiche apportate al passaggio Esegui script di Power Shell nell'interfaccia utente dell'editor della sequenza di attività:
    • -Sourcecode
    • -Workingdirectory
    • -OutputVariableName
    • -Timeout
    • -Nome utente
    • -Password
    • -SuccessCodes

Set-CMWindowsFirewallPolicy

Bug corretti

  • Set/Remove-CMWindowsFirewallPolicy -InputObject deve immettere il tipo corretto da New-CMWindowsFirewallPolicy.

Modifiche non di rilievo

  • Correzione della convalida del tipo.