Freigeben über

Änderungen der Configuration Manager Cmdlet-Bibliothek für Current Branch 1802

  • Artikel

Hinweis

System Center Configuration Current Branch 1710 ist die Baseline für diese Änderungen. Weitere Informationen finden Sie unter Configuration Manager Änderungen der Cmdlet-Bibliothek für Current Branch 1710.

Wichtige Änderungen

Das Installationsprogramm für die Administratorkonsole wurde aktualisiert, um das Importieren des ConfigurationManager-Moduls nach logischem Namen zu ermöglichen, ohne eine feste Verknüpfung von <installdir>\bin\ConfigurationManager zu zu verwenden <installdir>\bin.

Veraltete Cmdlets

Deaktivieren der automatischen PSDrive-Erstellung

Wenn das Modul ConfigurationManager.psd1 geladen wird, versucht PowerShell automatisch, eine Verbindung mit dem letzten SMS-Anbieter herzustellen, auf den über die Configuration Manager-Konsole zugegriffen wurde. In einigen Szenarien ist dieses Verbindungsverhalten möglicherweise nicht wünschenswert. Es wurde ein Benutzerregistrierungsschlüssel hinzugefügt, der dieses Verhalten deaktivieren kann und die manuelle Laufwerkerstellung erfordert. Verwenden Sie zum Konfigurieren des Verhaltens den Registrierungsschlüssel, HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell und legen Sie den Wert auf einen DWORD-Wert DisableCMDriveAutoCreate von 1 (automatische Laufwerkerstellung ist deaktiviert) oder 0 (Standardverhalten) fest. Durch löschen DisableCMDriveAutoCreate wird auch das Standardverhalten aktiviert.

Hinweis

Wenn die automatische Laufwerkerstellung deaktiviert ist, kann die Configuration Manager-Konsole beim Starten eines PowerShell-Fensters einen Fehler melden.

Bekannte Probleme

Die folgenden Elemente sind bekannte Probleme mit der Cmdlet-Bibliothek, die in dieser Version nicht behoben wurden.

New-CMCloudDistributionPoint

Das Cmdlet ist derzeit nicht funktionsfähig.

Problemumgehung

  • Keine

Get-CMAadConditionalAccessPolicy und Set-CMAadConditionalAccessPolicy

Für diese Cmdlets ist eine 64-Bit-PowerShell-Umgebung erforderlich.

Problemumgehung

  • Keine

Import-CMSecurityRole

Das Cmdlet schlägt möglicherweise mit einem DirectoryNotFoundException-Fehler fehl, der die Datei SecuredRoles.xsdauffindt.

Problemumgehung

  • Stellen Sie sicher, dass Import-Module für die ConfigurationManager.psd1 Datei und nicht für den logischen Pfad oder Modulnamen aufgerufen wird.

Set-CMSoftwareUpdatePoint

Änderungen am Zeitplan werden möglicherweise nicht in der Configuration Manager-Konsole angezeigt, obwohl das zugrunde liegende SMS-Anbieterobjekt geändert wurde.

Problemumgehung

  • Beenden Sie die Configuration Manager-Konsole, und starten Sie sie neu.

Neue Cmdlets

Die folgenden Elemente sind neu hinzugefügte Cmdlets für dieses Release, die neue Funktionen hinzufügen oder die Funktionalität vorhandener Cmdlets erweitern.

Co-Management-Cmdlets

New-CMCoManagementPolicy ermöglicht die Erstellung einer Co-Verwaltungsrichtlinie.

Cmdlets für globale Bedingungen

Neue Cmdlets wurden hinzugefügt, um das Erstellen und Ändern globaler Bedingungen zu unterstützen. Die Verben New und Set werden unterstützt.

  • CMGlobalConditionActiveDirectoryQuery
  • CMGlobalConditionAssembly
  • CMGlobalConditionFile
  • CMGlobalConditionIisMetabase
  • CMGlobalConditionRegistryKey
  • CMGlobalConditionRegistryValue
  • CMGlobalConditionScript
  • CMGlobalConditionSqlQuery
  • CMGlobalConditionWqlQuery
  • CMGlobalConditionXPathQuery
  • CMGlobalConditionOmaUri

Tasksequenz-Cmdlets

Neue Cmdlets wurden hinzugefügt, um das Ändern von Tasksequenzschritten zu unterstützen.

  • Tasksequenzbefehle (Die Verben Get, New, Remove und Set werden unterstützt)

    • CMTSCaptureNetworkSettings
    • CMTSCaptureSystemImage
    • CMTSCaptureUserState
    • CMTSCaptureWindowsSetting
    • CMTSConvertDisk
    • CMTSDisableBitLocker
    • CMTSEnableBitLocker
    • CMTSPrepareSmsClient
    • CMTSPrepareWindows
    • CMTSStepApplyDataImage
    • CMTSStepDownloadPackageContent
    • CMTSStepJoinDomainWorkgroup
    • CMTSStepOfflineEnableBitLocker
    • CMTSStepPrestartCheckAction
    • CMTSStepRestoreUserState
    • CMTSStepUpgradeOperatingSystem

  • Tasksequenzbedingungsbefehle

    • New-CMTSStepConditionOperatingSystemLanguage Cmdlet zum Erstellen einer Betriebssystemsprachbedingung.

  • Cmdlets zum Kopieren von Tasksequenzen

    • Copy-CMTaskSequence Cmdlet zum Erstellen einer Kopie einer vorhandenen Tasksequenz.

Convert-CMDeploymentType

Dieses Cmdlet ermöglicht das Abrufen eines nativen DeploymentType Objekts aus einer SMS_DeploymentType WMI-Objektinstanz. Kann mit Get-CMDeploymentTypekombiniert werden.

Ressourcennachverfolgung und -wiederherstellung (BETA)

Neue Cmdlets wurden hinzugefügt, um die Nachverfolgung von SMS-Anbieterobjekten zu unterstützen, die von der PowerShell-Runtime verwendet werden, und um diese Ressourcen zu bereinigen, wenn sie nicht mehr benötigt werden.

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

Wenn Start-CMObjectTracking ausgeführt wird, verfolgt die PowerShell-Runtime Objekte nach IResultObject , die von Cmdlet-Bibliotheks-Cmdlets erstellt wurden. Cmdlets, die nicht manuell mit bereinigt .Dispose() werden, können mit Disconnect-CMTrackedObject für ein einzelnes Objekt freigegeben werden.

Beispiel

# Reclaim all tracked objects
$o | Disconnect-CMTrackedObject```), or ```Disconnect-CMTrackedObject -All

Sobald ein Objekt freigegeben wurde, kann es nicht mehr wiederverwendet oder über die Objektpipeline an ein anderes Cmdlet übergeben werden.

Stop-CMObjectTracking kann verwendet werden, um die Objektnachverfolgung zu deaktivieren. Zuvor zugeordnete Objekte bleiben aktiv.

Nicht beanspruchte Ressourcen können dazu führen, dass fehler aufgrund von Kontingentverletzungen vom SMS-Anbieter ausgelöst werden. Diese Kontingentprobleme treten in der Regel durch die Arbeit mit großen Gruppen von SMS-Anbieterobjekten oder in Umgebungen mit langer Ausführungszeit auf.

Hinweis

Dies ist ein experimentelles Feature und kann in einer zukünftigen Version geändert oder entfernt werden. Dieses Feature ist aktiviert und nicht standardmäßig aktiviert.

Cmdlet-Änderungen

Die folgenden Änderungen wurden an vorhandenen Cmdlets für dieses Release vorgenommen. Änderungen können neue Funktionen, Fehlerbehebungen oder veraltete Funktionen sein. Einige Änderungen können nicht geändert werden. Wenn Sie eines der in diesem Abschnitt aufgeführten Cmdlets oder Featurebereiche verwenden, überprüfen Sie die Änderungen sorgfältig, um zu verstehen, wie sie sich auf Ihre Verwendung auswirken können.

PowerShell ISE

Behobene Fehler

Powershell_ise.exe Prozess kann beim Beenden abstürzen, wenn die ausführliche Protokollierung global aktiviert ist und das ConfigurationManager-Modul importiert wurde.

Tasksequenz-Cmdlets

Behobene Fehler

  • New-CMTSRule
    • Das Cmdlet schlägt möglicherweise fehl, wenn ein SecureString Variablentyp verwendet wird.
  • New-CMTSStepApplyOperatingSystem und Set-CMTSStepApplyOperatingSystem
    • Für DestinationLogicalDrive kann kein NULL-Wert angegeben werden.
    • Der Kleinbuchstabenwert für DestinationLogicalDrive kann zu einem Fehler bei der Überprüfung der Benutzeroberfläche führen.
  • New-CMTSStepApplyWindowsSetting und Set-CMTSStepApplyWindowsSetting
    • Die Verwendung von Kennwortparametern kann einen Fehler im SMS-Anbieter verursachen.
  • New-CMTSStepInstallSoftware und Set-CMTSStepInstallSoftware
    • Das Cmdlet lässt fälschlicherweise die Kombination der Parameter Program und EnableContinueOnInstallError zu.

Unterbrechungsfreie Änderungen

Verbesserte Parameterüberprüfung.

Add-CMComplianceSettingRegistryKeyValue

Behobene Fehler

ExpressionValue unterstützt nicht alle Kombinationen von Einstellungen mit ExpressionOperator. Korrigieren Sie das Verhalten, das nicht mit der Administratorkonsole übereinstimmt.

Unterbrechungsfreie Änderungen

Der RemediateDword-Parameter wurde hinzugefügt, um einen ganzzahligen Wert für die Wartung zu unterstützen.

Add-CMManagementPoint

Unterbrechungsfreie Änderungen

Verbesserte Parameterüberprüfung.

Add-CMMsiDeploymentType

Behobene Fehler

Das Cmdlet überprüft nicht, ob die Parameterkombinationen UninstallContentLocation und UninstallOption richtig verwendet werden.

Add-CMScriptDeploymentType

Behobene Fehler

Das Cmdlet erfordert fälschlicherweise die Verwendung des Skriptparameters , wenn AddDetectionClause verwendet wird.

Add-CMSoftwareUpdatePoint

Behobene Fehler

Beim Hinzufügen eines Softwareupdatepunkts zu einem Remotesystem gibt das Cmdlet möglicherweise einen Fehler zurück.

Enable-CMSiteFeature

Behobene Fehler

Wenn Vorabfeatures für die Hierarchie nicht aktiviert sind, schlägt das Cmdlet mit einer falsch formatierten Fehlermeldung fehl.

Get-CMApplication

Breaking Changes

Ausgeblendete Anwendungen sind jetzt nicht mehr standardmäßig enthalten. Der ShowHidden-Parameter wurde hinzugefügt, um die Anzeige ausgeblendeter Anwendungen im Resultset zu erzwingen.

Get-CMSiteInstallStatus

Behobene Fehler

Das Cmdlet kann eine ungültige Abfrage für den SMS-Anbieter ausführen.

Get-CMSiteStatusMessage

Behobene Fehler

Die Statusmeldungsabfrage gibt möglicherweise doppelte Nachrichten zurück.

New-CMBootableMedia

Behobene Fehler

Der DistributionPoint-Parameter ignoriert cloudfähige Verteilungspunkte nicht.

New-CMComplianceRuleFileFolderSize

Unterbrechungsfreie Änderungen

Verbesserte Parameterüberprüfung.

New-CMDetectionClauseMacPackage

Behobene Fehler

Verbesserte Parameterüberprüfung.

New-CMDetectionClauseWindowsInstaller

Behobene Fehler

Der ProductCode-Wert wird nicht ordnungsgemäß auf das Setting-Objekt angewendet.

New-CMExchangeServer

Unterbrechungsfreie Änderungen

FullSyncSchedule - oder DeltaSyncMins-Parameter sind nicht mehr obligatorisch und wenden einen Standardzeitplan an, wenn sie nicht verwendet werden.

New-CMInventoryReportClass**

Unterbrechungsfreie Änderungen

Der Name-Parameter wurde zum Definieren des Klassennamens hinzugefügt.

New-CMPrestagedMedia

Behobene Fehler

Cmdlet schlägt fehl, wenn eine Ausgabedatei mit der Erweiterung WIM angegeben wird.

New-CMProgram

Fehler, die abgelegt wurden

Der ProgramRunType-Parameterwert wurde möglicherweise fälschlicherweise auf Program angewendet.

New-CMSchedule

Behobene Fehler

RecurCount sollte den Wert 0nicht zulassen.

New-CMStandaloneMedia

Behobene Fehler

Das Cmdlet kann möglicherweise keine Medien erstellen, wenn MediaType ist Usb.

Unterbrechungsfreie Änderungen

Verbesserte Parameterüberprüfung.

New-CMStatusFilterRule

Unterbrechungsfreie Änderungen

Verbesserte Parameterüberprüfung.

New-CMStorageFolder

Unterbrechungsfreie Änderungen

Verbesserte Parameterüberprüfung.

New-CMTaskSequenceDeployment

Behobene Fehler

Das Cmdlet kann zwei Zeitpläne hinzufügen, wenn ScheduleEvent verwendet wird.

New-CMWirelessProfile

Unterbrechungsfreie Änderungen

Verbesserte Parameterüberprüfung.

Publish-CMPrestageContent

Behobene Fehler

Anwendung/Applicationname/ Die Verwendung des ApplicationId-Parameters kann dazu führen, dass das Cmdlet fehlschlägt.

Unterbrechungsfreie Änderungen

Leistungsverbesserungen.

Set-CMAntimalwarePolicy

Behobene Fehler

AddExcludedFilePath erstellt keine Standardausschlussregeln.

Set-CMApplication

Behobene Fehler

Das Ändern einer Anwendung mit mehreren Anzeigesprachen kann zu unerwarteten Änderungen am Anwendungszustand führen.

Unterbrechungsfreie Änderungen

Die Parameter AddAppCategory, AddUserCategory, RemoveAppCategory, RemoveUserCategory, CleanAppCategory und CleanUserCategory wurden hinzugefügt, um das Hinzufügen von Anwendungskategorien nach Objekt zu unterstützen.

Veraltete Funktionen

Die Parameter "AppCategory " und " UserCategory " wurden durch den neuen [Add| Entfernen sie| Bereinigen]AppCategory und [Hinzufügen| Entfernen sie| Bereinigen]UserCategory-Parameter.

Set-CMBoundary

Behobene Fehler

Der NewName-Parameter fehlt.

Unterbrechungsfreie Änderungen

Verbesserte Parameterüberprüfung.

Set-CMClientSettingClientcache

Veraltete Funktionen

Der EnableHttps-Parameter wird nicht mehr unterstützt.

Set-CMManagementPoint

Unterbrechungsfreie Änderungen

Verbesserte Parameterüberprüfung.

Set-CMMsiDeploymentType

Behobene Fehler

Das Cmdlet überprüft nicht, ob die Parameterkombinationen UninstallContentLocation und UninstallOption richtig verwendet werden.

Set-CMPackage

Behobene Fehler

Der UseMeteredNetwork-Parameter fehlt.

Set-CMSoftwareInventory

Unterbrechungsfreie Änderungen

Die Parameter CleanTag1, CleanTag2 und CleanTag3 wurden hinzugefügt, um das Entfernen von Tags zu unterstützen.

ParentSoftwareId, CategoryId-Parameter hinzugefügt.

Verbesserte Parameterüberprüfung.

Set-CMStatusFilterRule

Unterbrechungsfreie Änderungen

Verbesserte Parameterüberprüfung.

Set-CMUserDataAndProfileConfigurationItem

Unterbrechungsfreie Änderungen

Verbesserte Parameterüberprüfung.

Set-CMWirelessProfile

Unterbrechungsfreie Änderungen

Verbesserte Parametervalidierung für verschiedene Profilerstellungsszenarien.