Configuration Manager Cmdlet Library-Änderungen für Current Branch 1610
Hinweis
Die Version 1604 der Configuration Manager Cmdlet Library ist die Basis für diese Änderungen.
Die Administratorkonsole ermöglicht das Starten der integrierten Skriptumgebung (Integrated Scripting Environment, ISE)
Über die Administratorkonsole wurde eine zusätzliche Option zum Starten des ISE hinzugefügt: "Verbinden über Windows PowerShell ISE".
Die Cmdlet-Bibliothek sucht nicht mehr nach aktualisierten Versionen. Diese Überprüfung ist nicht mehr erforderlich, da die Cmdlet-Bibliothek jetzt gleichzeitig mit Configuration Manager Versionen ausgeliefert wird.
Get-CM*-Cmdlets unterstützen möglicherweise den "Fast"-Modus und geben möglicherweise eine Warnung zurück, wenn sie nicht verwendet wird.
Einige Get-Cmdlets verfügen jetzt über einen Fast-Parameter . Mit diesem Parameter kann das Cmdlet Objekte zurückgeben, ohne verzögerte Eigenschaften automatisch zu aktualisieren. Das Abrufen verzögerter Eigenschaftswerte kann zusätzlichen Netzwerkdatenverkehr verursachen und die Cmdlet-Ausführung verlangsamen. Wenn verzögerte Eigenschaften nicht verwendet werden, sollte Fast als Cmdlet-Parameter bereitgestellt werden.
Um Einen Einblick in diese Änderung zu bieten, schreiben Cmdlets, die Fast unterstützen, eine Warnung in die Konsole, wenn sie nicht in einem Fall verwendet wird, in dem ihr Vorhandensein von Vorteil sein kann. Diese Warnung kann durch Festlegen $CMPSSuppressFastNotUsedCheck = $Trueunterdrückt werden.
Viele der in diesem Dokument beschriebenen Korrekturen und Verbesserungen sind das Ergebnis von Kundenfeedback. Weitere Informationen finden Sie unter Produktfeedback.
Dies sind bekannte Probleme mit der Cmdlet-Bibliothek, die in dieser Version nicht behoben wurden.
Wenn der Pfad zum ConfigurationManager.psd1-Modul der PSMODULEPATH-Umgebungsvariablen hinzugefügt wird, kann er nicht mithilfe von Import-Module ConfigurationManager importiert werden.
Verwenden des vollständigen Pfads zum Modul
https://gallery.technet.microsoft.com/Make-Configuration-Manager-04474a87
Hinweis
Diese Problemumgehung wird von der Benutzercommunity bereitgestellt und nicht von Microsoft getestet oder unterstützt.
Cmdlet konfiguriert den Registrierungsproxypunkt möglicherweise nicht ordnungsgemäß, wenn mehrere Registrierungspunkte für den primären Standort vorhanden sind oder sich der Registrierungspunkt auf einem separaten Server befindet.
- Verwenden Sie die Administratorkonsole für diese Konfiguration.
Für diese Cmdlets ist eine 64-Bit-PowerShell-Umgebung erforderlich.
- Keine
Dies sind neu hinzugefügte Cmdlets für diese Version, die neue Funktionen hinzufügen oder die Funktionalität vorhandener Cmdlets verbessern.
Neue Cmdlets wurden geschrieben, um die Benutzerfreundlichkeit beim Ändern von Clienteinstellungen zu verbessern. Diese Cmdlets ersetzen das Cmdlet Set-CMClientSetting , das jetzt veraltet ist. Diese Cmdlets unterstützen die Verwendung der Objektpipeline aus dem Cmdlet "Get-CMClientSetting " zum Ändern von benutzerdefinierten Clienteinstellungen.
- Set-CMClientSettingBackgroundIntelligentTransfer
- Set-CMClientSettingClientCache
- Set-CMClientSettingClientPolicy
- Set-CMClientSettingCloudService
- Set-CMClientSettingComplianceSetting
- Set-CMClientSettingComputerAgent
- Set-CMClientSettingComputerRestart
- Set-CMClientSettingEndpointProtection
- Set-CMClientSettingEnrollment
- Set-CMClientSettingGeneral
- Set-CMClientSettingHardwareInventory
- Set-CMClientSettingMeteredInternetConnection
- Set-CMClientSettingPowerManagement
- Set-CMClientSettingRemoteTool
- Set-CMClientSettingSoftwareDeployment
- Set-CMClientSettingSoftwareInventory
- Set-CMClientSettingSoftwareMetering
- Set-CMClientSettingSoftwareUpdate
- Set-CMClientSettingStateMessaging
- Set-CMClientSettingUserAndDeviceAffinity
Neue Cmdlets wurden zur Unterstützung der Richtlinieneinstellungen für bedingten Zugriff in Azure Active Directory (Azure AD) geschrieben.
- Get-CMAadConditionalAccessPolicy
- Set-CMAadConditionalAccessPolicy
PR1:\> Get-CMAadConditionalAccessPolicy -AccountId 752c1e46-ddd2-4ffc-8f15-23623328c823 -ServicePrincipalType ExchangeOnline -UserCredential (Get-Credential)
PR1:\> Set-CMAadConditionalAccessPolicy -AccountId 752c1e46-ddd2-4ffc-8f15-23623328c823 -ServicePrincipalType ExchangeOnline -Enabled $true -TargetedDevicePlatforms Windows,WindowsPhone -WindowsDeviceState Compliant -IncludedSecurityGroup All_Users -UserCredential (Get-Credential)
Dieses Cmdlet kann verwendet werden, um eine vorhandene Sammlung in eine neue zu klonen.
Neue Cmdlets für advanced Threat Protection Policy Management:
- Get-CMAdvancedThreatProtectionPolicy
- New-CMAdvancedThreatProtectionPolicy
- Remove-CMAdvancedThreatProtectionPolicy
- Set-CMAdvancedThreatProtectionPolicy
Diese Cmdlets können zum Abrufen und Festlegen von Websitezusammenfassungsaufgaben verwendet werden.
Dieses Cmdlet kann verwendet werden, um den Vorproduktionsclient zum Produktionsstatus zu stufen.
PR1:\> Invoke-CMPromotePreProductionClient -Force
Neue Cmdlets für Migrationsaufträge:
- Get-CMMigrationJob
- Set-CMMigrationJob
Dieses Cmdlet kann verwendet werden, um eine Kategorie umzubenennen.
PR1:\> Get-CMCategory -Name MyCategoryName | Rename-CMCategory -NewName MyCategoryNewName -CategoryType AppCategories
Die folgenden Änderungen wurden an vorhandenen Cmdlets für diese Version vorgenommen. Änderungen können neue Funktionen, Fehlerbehebungen oder Veraltetheiten sein und möglicherweise zu Bruch gehen. Wenn Sie eines der in diesem Abschnitt aufgeführten Cmdlets oder Featurebereiche verwenden, überprüfen Sie die Änderungen sorgfältig, um zu verstehen, wie sich diese auf Ihre Verwendung auswirken können.
Bereitstellungstyp-Cmdlets, die einen URL-Parameter erfordern, überprüfen den Parameterwert möglicherweise nicht auf Korrektheit (z. B. Add-CMGooglePlayDeploymentType, Set-CMWindowsPhoneStoreDeploymentType).
Bereitstellungstyp-Cmdlets, die mobile Anwendungsverwaltung (MAM) unterstützen, fügen diese Details möglicherweise nicht zum Anwendungsmodell hinzu, wodurch die Registerkarte "App Configuration Richtlinien" in der Administratorkonsole fehlt.
Add-CM- <-Technologie>DeploymentType-Cmdlets erstellen keine Bereitstellungstypen mit derselben Benennungskonvention wie die Administratorkonsole.
Bereitstellungstyp-Cmdlets, die eine Datei anstelle eines Dateipfads erfordern (z . B. Add-CMMsiDeploymentType), melden jetzt eine klarere Fehlerursache, wenn für den ContentLocation-Parameter ein unerwartetes Argument angegeben wird.
Anbieterdaten, die _GENERIC WMI-Objekte darstellen_, zeigen jetzt weitere Daten in der Windows PowerShell Konsole an.
Das generierte Skript wurde aufgrund eines ungültigen Pfads zum ConfigurationManager-Modul nicht ausgeführt. Wenn bereits ein ungültiges Skript generiert wurde, entfernen Sie die vorhandene Datei "%TEMP%\ISEConnect_sitecode - sitename.ps1", und starten Sie den ISE über die Administratorkonsole neu.
Das generierte Skript kann unlesbar sein, wenn ein Sprachpaket für die Administratorkonsole installiert ist. Wenn bereits ein ungültiges Skript generiert wurde, entfernen Sie die vorhandene Datei %TEMP%\ISEConnect_sitecode - sitename.ps1, und starten Sie ISE aus der Administratorkonsole neu.
Beim Starten des ISE über die Administratorkonsole wird möglicherweise ein Fehler aufgrund eines ungültigen Pfads ausgelöst.
Cmdlet gibt möglicherweise eine Warnung "Unerwartete Websiteversion" zurück.
Das Cmdlet überprüft nicht die Gültigkeit der abfrage, die durch den Parameter QueryExpression angegeben wird. Abfrageregeln mit doppelten Namen können nicht erstellt werden (entspricht nicht dem Verhalten der Administratorkonsole).
Weitergeleitetes Objekt kann vom Cmdlet verworfen werden.
Das erstmalige Hinzufügen eines Endpunktschutzpunkts zu einer Website kann zu einer falschen Standardkonfiguration der Clienteinstellungen führen.
Der Parameter ContactEmail führt keine Überprüfung auf Korrektheit durch.
Der Parameterwert "EnableBranchCache " wird ignoriert.
Parameter "InstallationBehaviorType " hinzugefügt.
Der Parameterwert "EnableBranchCache " wird ignoriert.
Parameter "InstallationBehaviorType " hinzugefügt.
Das Cmdlet überprüft nicht die Gültigkeit der abfrage, die durch den Parameter QueryExpression angegeben wird.
Abfrageregeln mit doppelten Namen können nicht erstellt werden (entspricht nicht dem Verhalten der Administratorkonsole).
Cmdlet akzeptiert nun weitergeleitetes Objekt von Get-CMDevice.
Cmdlet erfordert nun, dass das ExportFilePath-Argument in einer MOF-Dateierweiterung endet.
Verbesserte Überprüfung des CategoryType-Parameters .
SettingType-Parameter kann ignoriert werden.
Unerwartete Abhängigkeiten können vom Cmdlet zurückgegeben werden.
Die neue Kennung für eine PinReset-Aktion kann nicht angezeigt werden.
Der Parameter "Fast" fehlt.
Wenn eine Verbindung mit einem primären Standort hergestellt wird und kein SiteCode-Parameter angegeben wird, werden nur Rollen zurückgegeben, die für die verbundene Website spezifisch sind. Diese Änderung wurde vorgenommen, um Parität und Konsistenz mit der Administratorkonsole zu haben. Wenn Sie beispielsweise über eine CAS verfügen und das Cmdlet auf einer primären Website ausführen, werden nur Websiterollen für den aktuellen Websitecode verwendet. Websiterollen für alle Websites werden zurückgegeben, wenn sie von einem CAS ausgeführt werden.
Um das vorherige Verhalten wiederherzustellen, kann der Parameter AllSites verwendet werden, um alle Websites innerhalb der Hierarchie von einer beliebigen verbundenen Website abzufragen.
Der Wert des UpdateGroup-Parameters kann vom Cmdlet verworfen werden.
Richtlinien, die aus früheren Versionen von Configuration Manager exportiert wurden, können möglicherweise nicht ordnungsgemäß importiert werden.
Die Richtlinie kann nicht importiert werden oder kann mit Überprüfungsfehlern erstellt werden.
Mit dem Cmdlet können Sie eine Datei importieren, die bereits importiert wurde.
Der Parameter "CollectionName " ist jetzt obligatorisch.
Unterstützung für den Import von Computern anhand ihres vollqualifizierten Domänennamens hinzugefügt.
Wenn ein teilweiser Treiberimport stattfindet, schlägt das Cmdlet nicht mehr fehl. Stattdessen wird gewarnt, dass einige Treiber nicht erfolgreich importiert wurden. In einem Fall, in dem keine Treiber importiert werden können, schlägt das Cmdlet weiterhin fehl.
Neuer ImportActionType-Parameter zum Steuern des Verhaltens, wenn bereits ein Paket vorhanden ist.
Neuer ImportActionType-Parameter zum Steuern des Verhaltens, wenn bereits ein Paket vorhanden ist.
Mit dem Cmdlet können ungültige NewRoleName-Parameterwerte verwendet werden.
Neuer ImportActionType-Parameter zum Steuern des Verhaltens, wenn bereits ein Paket vorhanden ist.
Cmdlet kann mit einer Ausnahme fehlschlagen, wenn bestimmte Ermittlungsinformationen für das Zielgerät nicht verfügbar sind.
Das Cmdlet schlägt im Hintergrund fehl, wenn der Benutzer nicht über die Berechtigung zum Aufrufen des Zurückstellungsvorgangs verfügt.
Cmdlet schlägt nicht mit einer klaren Fehlermeldung fehl, wenn versucht wird, ein nicht unterstütztes Gerät zurückzuziehen.
Cmdlet schlägt nicht mit einer klaren Fehlermeldung fehl, wenn versucht wird, ein zurückgesetztes Gerät zurückzuziehen.
Neuer Cancel-Parameter zum Abbrechen eines ausstehenden Geräts.
Das Cmdlet schlägt im Hintergrund fehl, wenn der Benutzer nicht über die Berechtigung zum Aufrufen des Zurücksetzungsvorgangs verfügt.
Cmdlet schlägt nicht mit einer klaren Fehlermeldung fehl, wenn versucht wird, ein nicht unterstütztes Gerät zu löschen.
Möglicherweise kann Intune nicht zurückgesetzt werden.
Neuer Cancel-Parameter zum Abbrechen einer ausstehenden Gerätezurücksetzung.
Weitergeleitetes Objekt kann vom Cmdlet verworfen werden.
Cmdlet kann ein zu verschiebenden Objekt nicht finden.
Cmdlet überprüft die Parameterwerte CertificateExpireTime und CertificateStartTime nicht ordnungsgemäß.
Die Parameter "PrestartCommand " und " PrestartPackage " wurden entfernt.
Cmdlet ermöglicht die Erstellung eines nicht unterstützten GlobalCondition-Kategorietyps.
Verbesserte Überprüfung des CategoryType-Parameters .
SettingType-Parameter ist jetzt obligatorisch.
Leistungsverbesserungen.
Gerätevariablen für ein primäres Websitemember können nicht aus dem CAS erstellt werden.
Das weitergeleitete Auflistungsobjekt kann vom Cmdlet verworfen werden.
Die Länge des InstanceName-Parameterwerts wird nicht überprüft.
Die Möglichkeit zum Erstellen von Base64- und XML-Einstellungsdatentypen wurde hinzugefügt.
Die Parameter DisplayOffMinAC und DisplayOffMinDC sind nicht im resultierenden Plan konfiguriert.
Die Parameter "MediaPassword", "TaskSequence" und "IncludeApplicationDependency" wurden hinzugefügt.
Cmdlet überprüft nicht, ob der Abfragename bereits vorhanden ist.
Das Rollback ist nicht konfiguriert, wenn der Parameter "UpgradeOperatingSystem " verwendet wird.
Aktualisierungen und Anwendungsschritte werden nicht an den erwarteten Positionen platziert, wenn der Parameter UpgradeOperatingSystem verwendet wird.
Das Registrierungsprofil enthält möglicherweise keine gültige Intranetkonfiguration.
Der nicht funktionale RoleName-Parameter wurde entfernt.
Weitergeleitetes Objekt kann vom Cmdlet verworfen werden.
Cmdlet schlägt im Hintergrund fehl, wenn versucht wird, eine nicht vorhandene Variable zu entfernen.
Gerätevariablen für ein primäres Websitemember können nicht aus der CAS entfernt werden.
Cmdlet kann ein gültiges pipelined-Auflistungsmemberobjekt ablehnen.
Cmdlet kann im Hintergrund oder mit einer unklaren Fehlermeldung fehlschlagen, wenn kein Microsoft Intune Abonnement vorhanden ist.
Cmdlet kann den Name-Parameter ignorieren und zusätzliche Wartungsfenster entfernen.
Cmdlet unterstützt den Parameterhinweis DisableWildcardHandling für den Name-Parameter .
Wenn Sie den Parameter RemoveWDS mit dem Wert "false" angeben, wird das WDS-Feature möglicherweise weiterhin entfernt.
Der Parameter "AddApplicationGroup " überprüft nicht, ob die Gruppe bereits hinzugefügt wurde.
Cmdlet ignoriert "OverrideServiceWindow " möglicherweise im Hintergrund, wenn die Erzwingung für die Bereitstellung nicht aktiviert ist.
Der DefaultSiteCode-Parameter lässt keinen NULL-Wert zum Löschen der Einstellung zu.
Cmdlet ist veraltet und wurde durch ein featurespezifisches Cmdlet ersetzt. Weitere Informationen finden Sie unter "Neue Cmdlets ".
Der Parameter "SiteSystemServerName " ist veraltet.
Eine Energieverwaltungsrichtlinie kann nicht von NeverApply in "Apply" geändert werden.
Das Cmdlet kann ausgeschlossene Auflistungen möglicherweise nicht ändern, wenn eine Richtlinie mithilfe der Parameter "Name " oder "ID" angegeben wird.
Cmdlet gibt möglicherweise eine Warnung "Unerwartete Websiteversion" zurück.
Cmdlet schlägt im Hintergrund fehl, wenn versucht wird, eine variable festzulegen, die nicht vorhanden ist.
Gerätevariablen für ein primäres Websitemember können nicht aus dem CAS konfiguriert werden.
Cmdlet kann ein gültiges pipelined-Auflistungsmemberobjekt ablehnen.
Neuer PassThru-Parameter zum Zurückgeben der resultierenden Gerätevariablen.
Cmdlet gibt möglicherweise unerwartete Warnungen zur Konfiguration des Multicast-Dienstpunkts zurück.
"FileReplicationAccountName" kann nicht festgelegt werden, ohne einen Replikationsmodus anzugeben.
Die Länge des InstanceName-Parameterwerts wird nicht überprüft.
Der Parameter ContactEmail führt keine Überprüfung auf Korrektheit durch.
Cmdlet warnt möglicherweise nicht, wenn bestimmte erforderliche Parameterabhängigkeiten nicht erfüllt sind.
Der Parameterwert "EnableBiometrics " kann ignoriert werden.
Cmdlet kann nicht fehlschlagen, wenn bestimmte ungültige Parameterkombinationen verwendet werden.
Das Angeben des UtcTime-Parameters ohne den Parameter "MigrationJobSchedule " kann zu einer ungültigen Konfiguration des Migrationsauftrags führen.
Cmdlet schlägt im Hintergrund fehl, wenn versucht wird, eine Migrationsquelle mit einem bereits vorhandenen Namen zu erstellen.
Cmdlet versucht, den Parameterwert "SourceSiteServerName " zu erweitern, wenn kein vollqualifizierter Domänenname verwendet wird.
Parameter "InstallationBehaviorType " hinzugefügt.
Parameter "InstallationBehaviorType " hinzugefügt.
Cmdlet kann fehlschlagen, wenn der SiteCode-Parameter verwendet wird.
Nicht verwendete zusätzliche Parametersätze wurden entfernt (SetSecurityScopeByName, SetSecurityScopeBySiteCode und SetSecurityScopeByValue).
Der Parameter "SiteCode " wurde entfernt.
Der Parameter "SummaryTask " ist veraltet. TaskName sollte stattdessen verwendet werden.
Akzeptiert weitergeleitete Eingaben von Get-CMSiteMaintenanceTask.
Mehrere Verbesserungen bei der Benutzerfreundlichkeit.
Parameter "TaskName" zum Festlegen einer Aufgabe anhand ihres Namens hinzugefügt.
Die Ausgabe bei Verwendung von Confirm oder WhatIf wurde verbessert.
"Local Publisher" kann nicht als Wert für den AddCompany-Parameter angegeben werden.
Die Ausgabe bei Verwendung von Confirm oder WhatIf wurde verbessert.
Das Cmdlet ignoriert "OverrideServiceWindow" möglicherweise automatisch, wenn die Erzwingung für die Bereitstellung nicht aktiviert ist.
Weitergeleitetes Objekt kann vom Cmdlet verworfen werden.
Die Bereitstellung wird möglicherweise nicht ordnungsgemäß erstellt, wenn der Parameter "DeploymentOption " nicht angegeben ist.
Cmdlet gibt möglicherweise eine Warnung zurück, dass die Parameter PercentSuccess oder PercentFailure ignoriert werden, wenn sie nicht angegeben werden.
Wenn DeploymentOption nicht angegeben ist, wird ein Wert von DownloadContentLocallyWhenNeededByRunningTaskSequence impliziert.
Cmdlet akzeptiert nun weitergeleitetes Objekt von Get-CMDevice.
Cmdlet schlägt jetzt fehl, wenn versucht wird, ein Objekt zu entsperren, das durch eine andere SMS-Anbietersitzung gesperrt ist. In früheren Versionen würde dies im Hintergrund fehlschlagen.
Der Parameter "Force" wurde hinzugefügt, um zu versuchen, Objekte zu entsperren, die möglicherweise von einer anderen SMS-Anbietersitzung gesperrt sind. Dies kann verwendet werden, um aus einem Szenario wiederherzustellen, in dem ein Objekt durch eine Administratorkonsole gesperrt wurde, die unerwartet beendet wurde, ohne die Objektsperre aufzugeben.