Änderungen an der Konfigurations-Manager-Cmdlet-Bibliothek für Current Branch 1702

Wichtige Änderungen

Aktualisierungen der Dokumentationsbibliothek

Die neueste Dokumentation zur Cmdlet-Bibliothek finden Sie in der ConfigurationManager-Modulreferenz.

Entfernte Cmdlets

Die folgenden Cmdlets werden nicht mehr unterstützt und wurden entfernt:

• Add-CMNokiaDeploymentType

• Add-CMOutOfBandServicePoint

• Add-CMSystemHealthValidatorPoint

• Clear-CMAmtAuditLog

• Disable-CMAmtAuditLog

• Enable-CMAmtAuditLog

• Enable-CMAutomaticAmtProvisioning

• Get-CMAutomaticAmtProvisioningStatus

• Get-CMCmdletUpdateCheck

• Get-CMOutOfBandManagementComponent

• Get-CMOutOfBandServicePoint

• Get-CMSystemHealthValidatorPoint

• Get-CMSystemHealthValidatorPointComponent

• New-CMWiredProfileObject

• New-CMWirelessProfileObject

• Remove-CMAmtProvisioningData

• Remove-CMNokiaDeploymentType

• Remove-CMOutOfBandServicePoint

• Remove-CMSystemHealthValidatorPoint

• Send-CMCmdletUpdateCheck

• Set-CMCmdletUpdateCheck

• Set-CMNokiaDeploymentType

• Set-CMOutOfBandManagementComponent

• Set-CMOutOfBandServicePoint

• Set-CMSystemHealthValidatorPointComponent

• Update-CMAmtProvisioning

Unterstützung für das Importieren des ConfigurationManager-Moduls mithilfe des logischen Namens

Das Importieren des ConfigurationManager-Moduls mithilfe eines logischen Namens oder Pfads wird jetzt unterstützt.

Wenn der Pfad C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin oder ein ähnlicher Pfad zur Variablen PSModulePath hinzugefügt wird, kann folgender Pfad verwendet werden:

Import-Module ConfigrationManager

Andernfalls kann Folgendes verwendet werden:

Import-Module 'C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin\ConfigurationManager'

Bekannte Probleme

Dies sind bekannte Probleme mit der Cmdlet-Bibliothek, die in dieser Version nicht behoben werden.

Get-CMAadConditionalAccessPolicy und Set-CMAadConditionalAccessPolicy

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

Problemumgehung

• Keine

Neue Cmdlets

Dies sind neu hinzugefügte Cmdlets für diese Version, mit denen neue Funktionen hinzugefügt oder die Funktionalität vorhandener Cmdlets erweitert wird.

iOS-Registrierungsprofil

Es wurden neue Cmdlets zum Konfigurieren von iOS-Registrierungsprofilen hinzugefügt.

• Get-CMIosEnrollmentProfile

• New-CMIosEnrollmentProfile

• Remove-CMIosEnrollmentPRofile

• Set-CMIosEnrollmentProfile

Cmdlets für das Cloudverwaltungsgateway

Es wurden neue Cmdlets zum Konfigurieren von Cloud Management Gateway-Standortrollen hinzugefügt.

• Add-CMCloudManagementGatewayConnectionPoint

• Get-CMCloudManagementGateway

• Get-CMCloudManagementGatewayConnectionPoint

• New-CMCloudManagementGateway

• Remove-CMCloudManagementGateway

• Remove-CMCloudManagementGatewayConnectionPoint

• Set-CMCloudManagementGateway

• Set-CMCloudManagementGatewayConnectionPoint

• Start-CMCloudManagementGateway

• Stop-CMCloudManagementGateway

Data Warehouse Servicepunkt-Cmdlets

Es wurden neue Cmdlets zum Konfigurieren von Standortrollen für Data Warehouse-Servicepunkte hinzugefügt.

• Add-CMDataWarehouseServicePoint

• Get-CMDataWarehouseServicePoint

• Remove-CMDataWarehouseServicePoint

• Set-CMDataWarehouseServicePoint

Cmdlets für die Bereitstellung

Es wurden mehrere neue Cmdlets geschrieben und Verbesserungen in Bezug auf Bereitstellungs- und Bereitstellungsüberwachungsszenarien vorgenommen.

Status der Inhaltsverteilung

Get-CMDistributionStatus ist ein neues Cmdlet, das verwendet werden kann, um die Verteilungs status von Inhaltsobjekten wie Anwendungen, Einstellungen oder Programmpaketen abzurufen.

Bereitstellungen abrufen

Cmdlets wurden erstellt, um das Objekt abzurufen, das einer tatsächlichen Bereitstellung zugeordnet ist.

• Get-CMApplicationDeployment

• Get-CMBaselineDeployment

• Get-CMConfigurationPolicyDeployment

• Get-CMPackageDeployment

• Get-CMSoftwareUpdateDeployment

• Get-CMTaskSequenceDeployment

Erstellung einer Bereitstellung

Es wurden Cmdlets zum Erstellen neuer Bereitstellungen erstellt. Diese Cmdlets ersetzen bereits vorhandene Start-CM*Deployment-Cmdlets.

• New-CMApplicationDeployment

• New-CMBaselineDeployment

• New-CMConfigurationPolicyDeployment

• New-CMPackageDeployment

• New-CMSoftwareUpdateDeployment

• New-TaskSequenceDeployment

Verbesserte Objektpipelineunterstützung

Set-CM*Deployment, Remove-CM*Deployment und Get-CM*DeploymentStatus unterstützen jetzt die Objektpipeline vollständig.

Start-CM-Funktion<>Bereitstellungscmdlets sind veraltet

Die folgenden Cmdlets für die Bereitstellung von Start-CM-Features<>sind veraltet. Die Ersatz-Cmdlets können sich in den Parameternamen unterscheiden, sollten aber identische und in einigen Fällen verbesserte Funktionalität aufweisen.

• Start-CMApplicationDeployment (ersetzt durch New-CMApplicationDeployment)

• Start-CMPackageDeployment (ersetzt durch New-CMPackageDeployment)

• Start-CMBaselineDeployment (ersetzt durch New-CMBaselineDeployment)

• Start-CMConfigurationPolicyDeployment (ersetzt durch New-CMConfigurationPolicyDeployment)

• Start-CMTaskSequenceDeployment (ersetzt durch New-CMTaskSequenceDeployment)

• Start-CMSoftwareUpdateDeployment (ersetzt durch New-CMSoftwareUpdateDeployment)

Get-CMResultantSettings

Dieses Cmdlet ruft die resultierenden Clienteinstellungen für eine Sammlung, ein Gerät oder einen Benutzer ab.

Updates für Betriebssystemupgradepakete

Neue Cmdlets zum Erstellen und Ändern von Updatezeitplänen für Betriebssystemupgradepakete wurden hinzugefügt.

• Clear-CMOperatingSystemUpgradeUpdateSchedule

• Get-CMOperatingSystemUpgradeUpdateSchedule

• New-CMOperatingSystemUpgradeUpdateSchedule

• Remove-CMOperatingSystemUpgradeUpdateSchedule

Remove-CMSoftwareUpdateFromGroup

Mit diesem Cmdlet wird ein Softwareupdate aus einer Softwareupdategruppe entfernt.

Cmdletänderungen

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

Sonstige Änderungen

Fehler, die behoben wurden

Große SMS_EmbeddedPropertyList Objekte, die von bestimmten Anbieterklassen verwendet werden, werden möglicherweise nicht ordnungsgemäß vom Cmdlet-Framework verwendet, was zu einem undefinierten Verhalten beim Abrufen oder Festlegen dieser Werte führt.

Bestimmte Kombinationen von Änderungen an Antischadsoftwarerichtlinien oder Clienteinstellungen können dazu führen, dass eine ungültige Richtlinie generiert wird. In diesem Zustand gibt der SMS-Anbieter den Fehler "Instanz ist keine gültige Client-Agent-Konfiguration" zurück.

Cmdlets zum Konfigurieren von Verwaltungspunkten und Softwareupdatepunkten wurde um den Parameter "EnableCloudGateway" erweitert, um die Verwendung dieser Rollen mit dem Cloudverwaltungsgateway zu aktivieren.

Konfiguration des Site-Wartungsfensters

Nicht unterbrechende Änderungen

CMMaintenanceWindow-Cmdlets unterstützen jetzt das Konfigurieren von Wartungsfenstern für Websites. Die Ausgabe von Get-CMSitekann per Pipeline an New, Remove oder Set-CMMaintenanceWindow weitergeleitet werden, um die Wartungsfenster für eine Site zu konfigurieren.

Add-CMDeploymentType

Wichtige Änderungen

Die Unterstützung für das Erstellen von Nokia-Bereitstellungstypen wurde entfernt.

Add-CMDeviceAfinityToUser

Fehler, die behoben wurden

Das Cmdlet schlägt möglicherweise unerwartet mit einem ObjectNotFound-Fehler fehl.

Add-CMDistributionPoint

Fehler, die behoben wurden

Mit dem Cmdlet können Sie einen Verteilungspunkt als internetfähig konfigurieren, wenn HTTPS nicht aktiviert ist.

Nicht unterbrechende Änderungen

Der Parameter "AllowProxyTraffic" wurde hinzugefügt.

Der zuvor nicht verwendete Parameter "InstallInternetServer" ändert jetzt die Konfiguration der Verteilungspunkte.

Veraltete Funktionen

Der Parameter "UseComputerAccount" ist veraltet. Um ein Computerkonto zu verwenden, legen Sie UserName auf $null fest.

Add-CMEnrollmentPoint

Fehler, die behoben wurden

Rolle für Registrierungspunkt Fehlende Konfigurationseinstellungen im erstellten Objekt.

Add-CMEnrollmentProxyPoint

Nicht unterbrechende Änderungen

Der Parameter "ServiceHost" wurde hinzugefügt, um die Angabe eines Remoteregistrierungspunkts zu ermöglichen.

Add-CMIntuneSubscription

Fehler, die behoben wurden

Der Parameter "ContactEmail" darf nicht auf Null oder einen leeren Wert festgelegt werden.

Add-CMMulticastServicePoint

Fehler, die behoben wurden

UserName überprüft nicht die korrekte Formatierung "DOMAIN\User".

Die Parameter StartUdpPort und EndUdpPort validieren keine Werte für bestimmte falsche Konfigurationen.

Die Parameter StartIPAddress und EndIPAddress validieren keine Werte für bestimmte falsche Konfigurationen.

Nicht unterbrechende Änderungen

UseAnyRangeIP-Parameter hinzugefügt.

Veraltete Funktionen

Der ClientTransferRate-Parameter wird nicht mehr unterstützt.

Approve-CMUserDeviceAffinityRequest

Fehler, die behoben wurden

Das Cmdlet ermöglicht die Genehmigung einer zuvor verarbeiteten Affinitätsanforderung.

Convert-CMSchedule

Fehler, die behoben wurden

Der Parameter InputObject akzeptiert kein pipelined-schedule-Objekt.

Deny-CMUserDeviceAffinityRequest

Fehler, die behoben wurden

Das Cmdlet ermöglicht das Ablehnen einer zuvor verarbeiteten Affinitätsanforderung.

Get-CMAlert

Fehler, die behoben wurden

Client Health- oder Endpoint Protection-Warnungen können nicht abgerufen werden.

Get-CMSiteStatusMessage

Nicht unterbrechende Änderungen

Parameter für ComputerName, Schweregrad und SiteCode akzeptieren jetzt Arraywerte.

Die Parameter "MessageId", "Module", "Component" und "FilterHashTable" wurden zur weiteren Filterung hinzugefügt.

Alle zeichenfolgenbasierten Filterparameter akzeptieren jetzt Platzhalter.

Get-CMWindowsEnrollmentProfilePackage

Fehler, die behoben wurden

Cmdlet ohne Parameter kann nicht angegeben werden.

Import-CMComputerInformation

Wichtige Änderungen

Das Cmdlet schlägt fehl, wenn ein bereits vorhandener Datensatz importiert wird und der neue Parameter "MergeIfExist" nicht angegeben ist.

Import-CMDriver

Fehler, die behoben wurden

Wenn ImportFolder verwendet wird, benötigen Treiberpakete möglicherweise mehr Speicherplatz als erwartet.

Install-CMClient

Nicht unterbrechende Änderungen

Unterstützung für Pipelineobjekte von Get-CMDevice und Get-CMResource wurde hinzugefügt.

Invoke-CMRemoteControl

Fehler, die behoben wurden

Das Cmdlet akzeptiert kein Pipelineobjekt von Get-CMSiteSystemServer.

Ein Standortsystemserver kann nicht für die Remotesteuerung vorgesehen sein, wenn er nicht gleichzeitig ein Clientcomputer ist.

New-CMActiveDirectoryForest

Nicht unterbrechende Änderungen

Der Parameter "UserName" wurde hinzugefügt, um die Konfiguration des Ermittlungskontos zu ermöglichen.

AddPublishingSite-Parameter hinzugefügt.

New-CMApplicationDeployment

Nicht unterbrechende Änderungen

Parameter "UpdateSupersedence" hinzugefügt.

New-CMBoundaryGroup

Wichtige Änderungen

FastLink ist der einzige unterstützte Wert für die Hashtabelle im AddSiteSystemServer-Parameter . Die Unterstützung für alle anderen Werte wurde entfernt.

New-CMCertificateProfilePfx

Fehler, die behoben wurden

Der Wert des KeyStorageProvider-Parameters gilt möglicherweise nicht wie erwartet für das neu erstellte Zertifikatprofil.

New-CMGlobalCondition

Wichtige Änderungen

Die Unterstützung für das Erstellen globaler Nokia-Bedingungen wurde entfernt.

New-CMProgram

Nicht unterbrechende Änderungen

Der Parameter AddSupportedOperatingSystemPlatform wurde hinzugefügt.

New-CMSoftwareUpdateAutoDeploymentRule

Fehler, die behoben wurden

Der Parameterwert MicrosoftAsVendor wird möglicherweise nicht auf die Regel angewendet.

Nicht unterbrechende Änderungen

Vendor-Parameter hinzugefügt, um Patches von Drittanbietern zu unterstützen.

Der Parameter "GenerateFailureAlert" wurde hinzugefügt.

New-CMSoftwareUpdateDeployment

Nicht unterbrechende Änderungen

Der Parameter "RequirePostRebootFullScan" wurde hinzugefügt.

New-CMStandaloneMedia

Nicht unterbrechende Änderungen

Parameter "MediaStartDate " und "MediaExpirationDate" wurden hinzugefügt, um den Medienablauf zu unterstützen.

Die Parameter "Application", "DriverPackage" und "Package " wurden zum Hinzufügen zusätzlicher Medieninhalte hinzugefügt.

New-CMStatusMessageQuery

Fehler, die behoben wurden

Die erstellte Abfrage wird möglicherweise nicht am erwarteten Speicherort der Administratorkonsole angezeigt.

New-CMWindowsEnrollmentProfile

Fehler, die behoben wurden

Der Parameter EnrollmentProxyPoint kann auf null oder einen leeren Wert festgelegt werden.

Der Wert des SiteCode-Parameters kann zu einem Validierungsfehler in der Administratorkonsole führen.

Remove-CMResource

Fehler, die behoben wurden

Durch das Entfernen einer Ressource werden keine staatlichen Migrationsverbände entfernt.

Remove-CMWindowsEnrollmentProfilePackage

Fehler, die behoben wurden

Beim Ausführen des Cmdlets kann ein Fehler "AmbiguousParameterSet" ausgelöst werden.

Set-CMActiveDirectoryForest

Nicht unterbrechende Änderungen

Der Parameter "UserName" wurde hinzugefügt, um die Konfiguration des Ermittlungskontos zu ermöglichen.

Die Parameter "AddPublishingSite" und "RemovePublishingSite" wurden hinzugefügt.

Set-CMAdvancedThreatProtectionPolicy

Fehler, die behoben wurden

Eine Erhöhung oder Verringerung der Priorität kann dazu führen, dass ein ObjectNotFound-Fehler zurückgegeben wird.

Set-CMAntimalwarePolicy

Fehler, die behoben wurden

WhatIf zeigt möglicherweise nicht den erwarteten Richtliniennamen an.

Die Einstellungen für den Echtzeitschutz können nicht geändert werden, wenn ein Pipelineobjekt verwendet wird.

Nicht unterbrechende Änderungen

Das Cmdlet akzeptiert jetzt pipelinegesteuerte Eingaben von Get-CMAntimalwarePolicy.

Set-CMApplication

Nicht unterbrechende Änderungen

Die Parameter AddSupportContact, AddOwner, RemoveSupportContact, RemoveOwner, ClearSupportContact und ClearOwner wurden hinzugefügt, um direkte Änderungen von Supportkontakten oder -besitzern zu unterstützen.

Set-CMAppVVirtualEnvironment

Fehler, die behoben wurden

PassThru gibt nicht das aktuellste Objekt zurück.

Set-CMBaseline

Fehler, die behoben wurden

PassThru gibt kein SMS_ConfigurationItem Objekt zurück.

Nicht unterbrechende Änderungen

ClearRequiredConfigurationItem, ClearProhibitedConfigurationItem, ClearOptionalConfigurationItem, ClearOSConfigurationItem, ClearSoftwareUpdate, ClearBaseline, RemoveRequiredConfigurationItem, RemoveOptionalConfigurationItem, RemoveProhibitedConfigurationItemRemoveOSConfigurationItem, RemoveSoftwareUpdate, RemoveBaseline, AddSoftwareUpdate- und AddBaseline-Parameter.

Set-CMBoundaryGroup

Wichtige Änderungen

FastLink ist der einzige unterstützte Wert für die Hashtabelle im AddSiteSystemServer-Parameter . Die Unterstützung für alle anderen Werte wurde entfernt.

Set-CMCertificateProfileTrustedRootCA

Fehler, die behoben wurden

Die Verwendung der Objektpipeline kann einen ParameterBindingException-Fehler verursachen.

Set-CMClientPushInstallation

Nicht unterbrechende Änderungen

Parameter "AddAccount " und "RemoveAccount " wurden hinzugefügt, um direkte Änderungen von Clientpushkonten zu unterstützen.

Set-CMClientSettingComputerAgent

Fehler, die behoben wurden

HealthAttestationUrl-Parameterwert ist nicht erforderlich, wenn EnableHealthAttestation oder UseOnPremisesHealthAttestation auf true festgelegt sind.

Set-CMComputerAssociation

Nicht unterbrechende Änderungen

Parameter "MigrationId" hinzugefügt.

Set-CMDeploymentType

Wichtige Änderungen

Die Unterstützung für das Ändern von Nokia-Bereitstellungstypen wurde entfernt.

Set-CMDiscoveryMethod

Fehler, die behoben wurden

Der PollingSchedule-Wert wird möglicherweise nicht ordnungsgemäß auf die Ermittlungsmethode angewendet.

Set-CMDistributionPoint

Fehler, die behoben wurden

Mit dem Cmdlet können Sie einen Verteilungspunkt als internetfähig konfigurieren, wenn HTTPS nicht aktiviert ist.

Nicht unterbrechende Änderungen

Der Parameter "AllowProxyTraffic" wurde hinzugefügt.

Der zuvor nicht verwendete Parameter "InstallInternetServer" ändert jetzt die Konfiguration der Verteilungspunkte.

Veraltete Funktionen

Der Parameter "UseComputerAccount" ist veraltet. Um ein Computerkonto zu verwenden, legen Sie UserName auf $null fest.

Set-CMEmailNotificationComponent

Nicht unterbrechende Änderungen

Parameter "UseSsl " hinzugefügt.

Set-CMFileReplicationRoute

Fehler, die behoben wurden

Der Parameter FileReplicationAccountName darf nicht auf null oder einen leeren Wert festgelegt werden.

Set-CMHierarchySetting

Nicht unterbrechende Änderungen

Die Parameter ExclusionCollection, ExclusionCollectionId, ExclusionCollectionName und EnableExclusionCollection wurden zum Konfigurieren von Clientupgradeausschlüssen hinzugefügt.

Set-CMIntuneSubscription

Fehler, die behoben wurden

Der Parameter "ContactEmail" darf nicht auf Null oder einen leeren Wert festgelegt werden.

Nicht unterbrechende Änderungen

Der Parameter "MaximumUserDevice" unterstützt jetzt einen Wert zwischen 1 und 15.

Set-CMIntuneSubscriptionWindowsPhoneProperty

Fehler, die behoben wurden

Das Cmdlet schlägt möglicherweise unerwartet mit einem AetCleanupFailure-Fehler fehl.

Set-CMMaintenanceTask

Fehler, die behoben wurden

Der PassThru-Parameter bewirkt nicht, dass ein Objekt zurückgegeben wird.

Set-CMMulticastServicePoint

Fehler, die behoben wurden

Der Parameter "UserName" überprüft nicht den Wert für die korrekte Formatierung "DOMAIN\User".

Die Parameter StartUdpPort und EndUdpPort validieren keine Werte für bestimmte falsche Konfigurationen.

Die Parameter StartIPAddress und EndIPAddress validieren keine Werte für bestimmte falsche Konfigurationen.

Nicht unterbrechende Änderungen

UseAnyRangeIP-Parameter hinzugefügt.

Veraltete Funktionen

Der ClientTransferRate-Parameter wird nicht mehr unterstützt.

Set-CMProgram

Nicht unterbrechende Änderungen

Die Parameter AddSupportedOperatingSystemPlatform, RemoveSupportedOperatingSystemPlatform und RunOnAnyPlatform wurden hinzugefügt.

Set-CMSite

Fehler, die behoben wurden

RemoveClientRequestServiceType entfernt den angegebenen Wert möglicherweise nicht ordnungsgemäß.

Nicht unterbrechende Änderungen

Die Parameter SiteSystemCollectionBehavior, ThresholdOfSelectCollectionMax, ThresholdOfSelectCollectionByDefault und ThresholdOfSelectCollectionMax wurden hinzugefügt, um Gerätesammlungsschwellenwerte für eine Website zu konfigurieren.

Set-CMSiteSummaryTask

Fehler, die behoben wurden

Der PassThru-Parameter bewirkt nicht, dass ein Objekt zurückgegeben wird.

Set-CMSoftwareUpdateAutoDeploymentRule

Fehler, die behoben wurden

Der Parameterwert MicrosoftAsVendor wird möglicherweise nicht auf die Regel angewendet.

Nicht unterbrechende Änderungen

Vendor-Parameter hinzugefügt, um Patches von Drittanbietern zu unterstützen.

Der Parameter "GenerateFailureAlert" wurde hinzugefügt.

Set-CMSoftwareUpdateDeployment

Nicht unterbrechende Änderungen

Der Parameter "RequirePostRebootFullScan" wurde hinzugefügt.

Set-CMSoftwareUpdatePointComponent

Fehler, die behoben wurden

Die Verwendung von EnableSynchronization und Schedule-Parametern kann dazu führen, dass falsche Warnungen generiert werden oder der Zeitplan nicht wie erwartet geändert wird.

Set-CMStatusFilterRule

Fehler, die behoben wurden

Änderungen am Wert des Prioritätsparameters gelten möglicherweise nicht für die Filterregel "Status".

Set-CMTaskSequence

Veraltete Funktionen

Der UseDefaultText-Parameter ist veraltet. Um den Standardtext zu verwenden, legen Sie CustomText auf $null fest.

Set-CMWindowsEnrollmentProfile

Fehler, die behoben wurden

Der Autoritätsparameter ist nicht in allen Parametersätzen verfügbar.