Konfigurations-Manager Cmdlet-Bibliotheksänderungen für Current Branch 1802

Wichtige Änderungen

Die Verwaltungskonsole erstellt keinen festen Link mehr für das PowerShell-Modul

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

Veraltete Cmdlets

• New-CMGlobalCondition und Set-CMGlobalCondition wurden durch die neue Familie der Cmdlets für globale Bedingungen ersetzt.

Deaktivieren Sie die automatische Erstellung von PSDrive

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

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 beim Suchen der Datei SecuredRoles.xsdfehl.

Problemumgehung

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

Set-CMSoftwareUpdatePoint

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

Problemumgehung

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

Neue Cmdlets

Bei den folgenden Elementen handelt es sich um neu hinzugefügte Cmdlets in dieser Version, mit denen neue Funktionen hinzugefügt oder die Funktionalität vorhandener Cmdlets erweitert wird.

Co-Management Cmdlets

New-CMCoManagementPolicy ermöglicht die Erstellung einer Richtlinie für die gemeinsame Verwaltung.

Cmdlets für globale Bedingungen

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

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

Tasksequenz-Cmdlets

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

• Tasksequenzbefehle (Get, New, Remove und Set verbs supported)

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

• Befehle für Tasksequenzbedingungen

  • New-CMTSStepConditionOperatingSystemLanguage Cmdlet zum Erstellen einer Betriebssystem-Sprachbedingung.

• Cmdlets zum Kopieren von Tasksequenzen

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

Convert-CMDeploymentType

Dieses Cmdlet ermöglicht das Abrufen eines systemeigenen DeploymentType Objekts aus einer SMS_DeploymentType WMI-Objekt-instance. Kombinierbar mit Get-CMDeploymentType.

Ressourcennachverfolgung und -wiederherstellung (BETA)

Es wurden neue Cmdlets hinzugefügt, um die Verfolgung von SMS-Anbieterobjekten zu unterstützen, die von der PowerShell-Laufzeit verwendet werden, und um diese Ressourcen zu sauber zu machen, wenn sie nicht mehr benötigt werden.

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

Bei Start-CMObjectTracking der Ausführung verfolgt die PowerShell-Laufzeit Objekte nach IResultObject , die von Cmdlets der Cmdlet-Bibliothek erstellt wurden. Cmdlets, die .Dispose() nicht manuell bereinigt werden, können zurückgefordert werden, indem sie für ein einzelnes Objekt verwendet Disconnect-CMTrackedObject 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 Objektverfolgung zu deaktivieren. Zuvor zugeordnete Objekte bleiben aktiv.

Nicht beanspruchte Ressourcen können dazu führen, dass der SMS-Anbieter Fehler wegen Kontingentverletzung auslöst. Diese Kontingentprobleme treten in der Regel bei der Arbeit mit großen Mengen von SMS-Anbieterobjekten oder in Umgebungen mit langer Ausführungszeit auf.

Cmdletänderungen

Die folgenden Änderungen wurden an vorhandenen Cmdlets für diese Version vorgenommen. Änderungen können neue Funktionen, Fehlerbehebungen oder veraltete Updates sein. Einige Änderungen können fehlerhaft sein. 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

Fehler, die behoben wurden

Powershell_ise.exe Prozess stürzt möglicherweise beim Beenden ab, wenn die ausführliche Protokollierung global aktiviert ist und das ConfigurationManager-Modul importiert wurde.

Tasksequenz-Cmdlets

Fehler, die behoben wurden

• New-CMTSRule
  • Das Cmdlet schlägt möglicherweise fehl, wenn ein SecureString Variablentyp verwendet wird.
• New-CMTSStepApplyOperatingSystem und Set-CMTSStepApplyOperatingSystem
  • Es kann kein Nullwert für DestinationLogicalDrive angegeben werden.
  • Ein Kleinwert 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 das Kombinieren der Parameter " Program " und " EnableContinueOnInstallError" zu.

Nicht unterbrechende Änderungen

Verbesserte Parametervalidierung.

Add-CMComplianceSettingRegistryKeyValue

Fehler, die behoben wurden

ExpressionValue unterstützt nicht alle Kombinationen von Einstellungen mit ExpressionOperator. Behebungsverhalten entspricht nicht der Administratorkonsole.

Nicht unterbrechende Änderungen

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

Add-CMManagementPoint

Nicht unterbrechende Änderungen

Verbesserte Parametervalidierung.

Add-CMMsiDeploymentType

Fehler, die behoben wurden

Das Cmdlet überprüft nicht die korrekte Verwendung der Parameterkombinationen UninstallContentLocation und UninstallOption .

Add-CMScriptDeploymentType

Fehler, die behoben wurden

Das Cmdlet erfordert bei Verwendung von AddDetectionClause fälschlicherweise die Verwendung des Skriptparameters.

Add-CMSoftwareUpdatePoint

Fehler, die behoben wurden

Das Cmdlet gibt möglicherweise einen Fehler zurück, wenn ein Softwareupdatepunkt zu einem Remotesystem hinzugefügt wird.

Enable-CMSiteFeature

Fehler, die behoben wurden

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

Get-CMApplication

Wichtige Änderungen

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

Get-CMSiteInstallStatus

Fehler, die behoben wurden

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

Get-CMSiteStatusMessage

Fehler, die behoben wurden

Die Abfrage von Statusmeldungen kann doppelte Nachrichten zurückgeben.

New-CMBootableMedia

Fehler, die behoben wurden

Der DistributionPoint-Parameter ignoriert keine cloudfähigen Verteilungspunkte.

New-CMComplianceRuleFileFolderSize

Nicht unterbrechende Änderungen

Verbesserte Parametervalidierung.

New-CMDetectionClauseMacPackage

Fehler, die behoben wurden

Verbesserte Parametervalidierung.

New-CMDetectionClauseWindowsInstaller

Fehler, die behoben wurden

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

New-CMExchangeServer

Nicht unterbrechende Änderungen

Die Parameter FullSyncSchedule oder DeltaSyncMins sind nicht mehr obligatorisch und wenden bei Nichtverwendung einen Standardzeitplan an.

New-CMInventoryReportClass**

Nicht unterbrechende Änderungen

Name-Parameter zum Definieren des Klassennamens hinzugefügt.

New-CMPrestagedMedia

Fehler, die behoben wurden

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

New-CMProgram

Bugs, die abgelegt wurden

Der Parameterwert "ProgramRunType" wird möglicherweise falsch auf das Programm angewendet.

New-CMSchedule

Fehler, die behoben wurden

RecurCount sollte den Wert .0

New-CMStandaloneMedia

Fehler, die behoben wurden

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

Nicht unterbrechende Änderungen

Verbesserte Parametervalidierung.

New-CMStatusFilterRule

Nicht unterbrechende Änderungen

Verbesserte Parametervalidierung.

New-CMStorageFolder

Nicht unterbrechende Änderungen

Verbesserte Parametervalidierung.

New-CMTaskSequenceDeployment

Fehler, die behoben wurden

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

New-CMWirelessProfile

Nicht unterbrechende Änderungen

Verbesserte Parametervalidierung.

Publish-CMPrestageContent

Fehler, die behoben wurden

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

Nicht unterbrechende Änderungen

Leistungsverbesserungen.

Set-CMAntimalwarePolicy

Fehler, die behoben wurden

AddExcludedFilePath erstellt keine Standardausschlussregeln.

Set-CMApplication

Fehler, die behoben wurden

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

Nicht unterbrechende Änderungen

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 die neuen Parameter "[Add|Entfernen|Clean]AppCategory und [Add|Entfernen|Clean]UserCategory Parameter.

Set-CMBoundary

Fehler, die behoben wurden

NewName-Parameter fehlt.

Nicht unterbrechende Änderungen

Verbesserte Parametervalidierung.

Set-CMClientSettingClientcache

Veraltete Funktionen

Der Parameter "EnableHttps " wird nicht mehr unterstützt.

Set-CMManagementPoint

Nicht unterbrechende Änderungen

Verbesserte Parametervalidierung.

Set-CMMsiDeploymentType

Fehler, die behoben wurden

Das Cmdlet überprüft nicht die korrekte Verwendung der Parameterkombinationen UninstallContentLocation und UninstallOption .

Set-CMPackage

Fehler, die behoben wurden

Der Parameter UseMeteredNetwork fehlt.

Set-CMSoftwareInventory

Nicht unterbrechende Änderungen

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

ParentSoftwareId, CategoryId-Parameter hinzugefügt.

Verbesserte Parametervalidierung.

Set-CMStatusFilterRule

Nicht unterbrechende Änderungen

Verbesserte Parametervalidierung.

Set-CMUserDataAndProfileConfigurationItem

Nicht unterbrechende Änderungen

Verbesserte Parametervalidierung.

Set-CMWirelessProfile

Nicht unterbrechende Änderungen

Verbesserte Parametervalidierung für verschiedene Profilerstellungsszenarien.