Dela via

Konfigurationshanteraren ändringar i cmdlet-biblioteket för version 2107

  • Artikel

Gäller för: Konfigurationshanteraren (aktuell gren)

Den här versionsanteckningarna sammanfattar ändringar Konfigurationshanteraren cmdlet-biblioteket i version 2107.

Anteckning

Konfigurationshanteraren version 2103 av den aktuella grenen är baslinjen för dessa ändringar. Mer information finns i Konfigurationshanteraren ändringar i cmdlet-biblioteket för version 2103.

Nya cmdlets för appdistributionstyper

Hantera installationsbeteenden för programdistributionstyper

Den här uppsättningen nya cmdlets är för installationsbeteende för programdistributionstyp. Mer allmän information om funktionen för installationsbeteende finns i Kontrollera om körbara filer körs.

Add-CMDeploymentTypeInstallBehavior

Använd den här cmdleten för att lägga till de körbara filer som måste stängas för att appinstallationen ska lyckas i den angivna distributionstypen.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -DisplayName "Notepad"

Mer information finns i Add-CMDeploymentTypeInstallBehavior.

Get-CMDeploymentTypeInstallBehavior

Använd den här cmdleten för att hämta listan över körbara filer som måste stängas för att appinstallationen ska lyckas från den angivna distributionstypen.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Get-CMDeploymentTypeInstallBehavior -InputObject $msi_dt

Mer information finns i Get-CMDeploymentTypeInstallBehavior.

Remove-CMDeploymentTypeInstallBehavior

Använd den här cmdleten för att ta bort de körbara filer som måste stängas för att appinstallationen ska lyckas från den angivna distributionstypen.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe"

Mer information finns i Remove-CMDeploymentTypeInstallBehavior.

Set-CMDeploymentTypeInstallBehavior

Använd den här cmdleten för att ändra de körbara filer som måste stängas för att appinstallationen ska lyckas.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Set-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -NewExeFileName "calc.exe" -DisplayName "Calculator"

Mer information finns i Set-CMDeploymentTypeInstallBehavior.

Hantera returkoder för programdistributionstyper

Den här uppsättningen nya cmdlets är för returkoder för programdistributionstyp. Mer allmän information finns i Distributionstypen Returkoder.

Add-CMDeploymentTypeReturnCode

Använd den här cmdleten för att lägga till returkoder till en distributionstyp som stöds.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602 -Name "User cancel" -CodeType Failure -Description "The user cancelled the installation"

Mer information finns i Add-CMDeploymentTypeReturnCode.

Get-CMDeploymentTypeReturnCode

Använd den här cmdleten för att hämta listan över returkoder från den angivna distributionstypen.

Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)" | Get-CMDeploymentTypeReturnCode

Mer information finns i Get-CMDeploymentTypeReturnCode.

Remove-CMDeploymentTypeReturnCode

Använd den här cmdleten för att ta bort returkoder från den angivna distributionstypen.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602

Mer information finns i Remove-CMDeploymentTypeReturnCode.

Set-CMDeploymentTypeReturnCode

Använd den här cmdleten för att ändra returkoder för den angivna distributionstypen.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 3010 -Name "Always reboot" -CodeType HardReboot -Description "Change soft reboot to hard reboot"

Mer information finns i Set-CMDeploymentTypeReturnCode.

Andra nya cmdlets

Get-CMClientSettingDeployment

Använd den här cmdleten för att hämta en distribution av ett anpassat klientinställningsobjekt. Du kan använda det här objektet med Remove-CMClientSettingDeployment.

Mer information om klientinställningar finns i Så här konfigurerar du klientinställningar.

$clientSetting =  Get-CMClientSetting -Name "Software Center customizations"
$clientSetting | Get-CMClientSettingDeployment

Mer information finns i Get-CMClientSettingDeployment.

Get-CMDeploymentTypeDetectionClause

Använd den här cmdleten för att hämta identifieringssatserna från den angivna distributionstypen.

Du kan använda den här cmdleten för att hämta en identifieringssats från en app och tillämpa den på en annan, till exempel:

$appMsi = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"

$clause1 = Get-CMDeploymentTypeDetectionClause -InputObject $appMsi

Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause1

Mer information finns i Get-CMDeploymentTypeDetectionClause.

Get-CMPersistentUserSettingsGroup

Använd den här cmdleten för att hämta listan över platsomfattande inställningar som du har lagrat. De här inställningarna följer dig på olika enheter.

Till exempel Konfigurationshanteraren-konsolmeddelanden som är aktiva eller som du har avvisat.

Mer information finns i Get-CMPersistentUserSettingsGroup.

Get-CMSoftwareUpdateContentInfo

Använd den här cmdleten för att hämta information om programuppdateringsinnehåll.

$update = Get-CMSoftwareUpdate -ArticleId "5004237" -Fast
Get-CMSoftwareUpdateContentInfo -InputObject $update[1]

Mer information finns i Get-CMSoftwareUpdateContentInfo.

Remove-CMPersistentUserSettingsGroup

Använd den här cmdleten för att återställa inställningarna för hela webbplatsen.

Du kan till exempel återställa Konfigurationshanteraren konsolmeddelanden som du har avvisat. När du har kört den här cmdleten och Konfigurationshanteraren omstart av konsolen visas alla tillgängliga meddelanden igen.

Mer information finns i Remove-CMPersistentUserSettingsGroup.

Inaktuella och borttagna cmdlets

Följande cmdlets för att starta en distribution är inaktuella och kan tas bort i en framtida version:

Inaktuella cmdletar Ny funktion
Start-CMApplicationDeploymentSimulation New-CMApplicationDeployment med simuleringsparametern
Start-CMClientSettingDeployment New-CMClientSettingDeployment
Start-CMAntimalwarePolicyDeployment New-CMAntimalwarePolicyDeployment

Följande cmdlets är inte längre tillgängliga eftersom de underliggande funktionerna inte längre stöds:

  • Add-CMApplicationCatalogWebServicePoint

  • Add-CMApplicationCatalogWebsitePoint

  • Get-CMApplicationCatalogWebServicePoint

  • Get-CMApplicationCatalogWebsitePoint

  • Remove-CMApplicationCatalogWebServicePoint

  • Remove-CMApplicationCatalogWebsitePoint

  • Set-CMApplicationCatalogWebsitePoint

  • Get-CMVhd

  • New-CMVhd

  • Remove-CMVhd

  • Set-CMVhd

Ändringar i cmdleten

Följande ändringar har gjorts i befintliga cmdlets i den här versionen. Ändringar kan vara nya funktioner eller felkorrigeringar. Vissa ändringar kan vara större. Om du använder en av cmdletarna eller funktionsområdena som anges i det här avsnittet granskar du ändringarna noggrant för att förstå hur de kan påverka din användning.

Add-CMDeviceCollectionDirectMembershipRule

Mer information finns i Add-CMDeviceCollectionDirectMembershipRule.

Buggar som har åtgärdats

Ett problem vid försök att lägga till tusentals enheter som regler för direkt medlemskap har åtgärdats.

Add-CMDistributionPoint

Mer information finns i Add-CMDistributionPoint.

Icke-bakåtkompatibla ändringar

Det minsta lediga standardutrymmet har ändrats från 50 MB till 500 MB.

Add-CMTaskSequenceStep

Mer information finns i Add-CMTaskSequenceStep.

Icke-icke-icke-större ändringar

Den onödiga parametern StepName har tagits bort.

Disconnect-CMTrackedObject

Mer information finns i Disconnect-CMTrackedObject.

Icke-icke-icke-större ändringar

Aliaset Disconnect-CMObject har lagts till för denna cmdlet.

Get-CMApplicationGroup

Mer information finns i Get-CMApplicationGroup.

Buggar som har åtgärdats

Ett problem har åtgärdats för att hämta rätt sökväg för appgruppen.

Get-CMDeploymentStatusDetails

Mer information finns i Get-CMDeploymentStatusDetails.

Buggar som har åtgärdats

Frågevillkor har åtgärdats för att undvika problem med matchningsfel av typen.

Import-CMAntimalwarePolicy

Mer information finns i Import-CMAntimalwarePolicy.

Icke-icke-icke-större ändringar

Stöd har lagts till för granskningslägesprincip med potentiellt oönskade program. Mer information finns i Granskningsläge för potentiellt oönskade program.

Import-CMQuery

Mer information finns i Import-CMQuery.

Buggar som har åtgärdats

Ett problem för att avblockera importfunktionen har åtgärdats.

New-CMAdministrativeUser

Mer information finns i New-CMAdministrativeUser.

Buggar som har åtgärdats

Ett problem har åtgärdats när användarnamnet är me .

New-CMApplicationDeployment

Mer information finns i New-CMApplicationDeployment.

Icke-icke-icke-större ändringar

Parametern AutoCloseExecutable har lagts till för att aktivera programdistributionsinställningen för installationsbeteenden.

New-CMCloudManagementGateway

Mer information finns i New-CMCloudManagementGateway.

Icke-bakåtkompatibla ändringar

Parametern ServiceCertPassword krävs nu.

New-CMMigrationJob

Mer information finns i New-CMMigrationJob.

Buggar som har åtgärdats

Avblockerade migreringen av distributionsobjekt för programdistribution.

New-CMSecondarySite

Mer information finns i New-CMSecondarySite.

Icke-bakåtkompatibla ändringar

Standardvärdet för ledigt utrymme har ändrats från 200 MB till 500 MB.

New-CMSoftwareUpdateAutoDeploymentRule

Mer information finns i New-CMSoftwareUpdateAutoDeploymentRule.

Buggar som har åtgärdats

Ett problem med parametern Product har åtgärdats. När det finns flera produkter med samma namn väljer den nu alla.

New-CMSoftwareUpdateDeployment

Mer information finns i New-CMSoftwareUpdateDeployment.

Icke-icke-icke-större ändringar

Description-alias har lagts till i parametern Comment.

New-CMTaskSequence

Mer information finns i New-CMTaskSequence.

Icke-icke-icke-större ändringar

  • Utökade den maximala längden för parametern Beskrivning till 512 tecken.

  • Den nya parametern HighPerformance har lagts till för att stödja prestandainställningar.

  • Den äldre parametern InstallationLicensingMode har tagits bort.

  • Parameteruppsättningen NewInstallOSImageVhd har tagits bort.

  • Parametern InstallOperatingSystemImageVhd har tagits bort.

New-CMTaskSequenceDeployment

Mer information finns i New-CMTaskSequenceDeployment.

Buggar som har åtgärdats

Åtgärdat ett problem med energisparplaner med höga prestanda.

New-CMTSStepApplyDriverPackage

Mer information finns i New-CMTSStepApplyDriverPackage.

Icke-icke-icke-större ändringar

Ett villkor har lagts till för att validera ett paket för det angivna PackageId.

New-CMTSStepApplyOperatingSystem

Mer information finns i New-CMTSStepApplyOperatingSystem.

Buggar som har åtgärdats

Verifieringsproblem med parametern DestinationVariable har åtgärdats för att tillåta värden som börjar med ett understreck ( _ ).

Icke-icke-icke-större ändringar

Parametern LayeredDriver har lagts till för att stödja tangentbordsdrivrutiner i flera lager under distributionen av operativsystemet.

New-CMTSStepUpgradeOperatingSystem

Mer information finns i New-CMTSStepUpgradeOperatingSystem.

Icke-icke-icke-större ändringar

Den nya parametern SoftwareUpdate har lagts till för att ange en funktionsuppdatering för aktivitetssekvenssteget Uppgradera operativsystem.

Publish-CMPrestageContent

Mer information finns i Publish-CMPrestageContent.

Buggar som har åtgärdats

Ett potentiellt problem med ogiltigt objekt har åtgärdats.

Remove-CMApplicationGroup

Mer information finns i Remove-CMApplicationGroup.

Buggar som har åtgärdats

Ett problem har åtgärdats för att hämta rätt appgruppsökväg när du använder pipelinen.

Set-CMAntimalwarePolicy

Mer information finns i Set-CMAntimalwarePolicy.

Icke-icke-icke-större ändringar

Parametern PuaProtection har lagts till för att stödja potentiellt oönskade program.

Set-CMApplicationDeployment

Mer information finns i Set-CMApplicationDeployment.

Icke-icke-icke-större ändringar

Parametern AutoCloseExecutable har lagts till för att aktivera programdistributionsinställningen för installationsbeteenden.

Set-CMClientSetting

Mer information finns i Set-CMClientSetting.

Icke-icke-icke-större ändringar

Ett meningsfullt utfasningsmeddelande för parametern SoftwareMetering har lagts till.

Set-CMClientSettingSoftwareUpdate

Mer information finns i Set-CMClientSettingSoftwareUpdate.

Icke-icke-icke-större ändringar

Parametern EnableWsusCertPinning har lagts till för att stödja fästa certifikat.

Set-CMDeploymentType

Mer information finns i Set-CMDeploymentType.

Buggar som har åtgärdats

Ett problem med parametern AddRequirement har åtgärdats för att lägga till nya regler.

Set-CMMsiDeploymentType

Mer information finns i Set-CMMsiDeploymentType.

Buggar som har åtgärdats

Uppdatera distributionstypen enligt installationstyp för att undvika att återställa konfigurationerna när du ändrar innehållsplatsen.

Icke-icke-icke-större ändringar

Lägg till stöd för att ange en mappsökväg till parametern ContentLocation.

Set-CMTaskSequence

Mer information finns i Set-CMTaskSequence.

Icke-icke-icke-större ändringar

Den nya parametern HighPerformance har lagts till för att stödja prestandainställningen för aktivitetssekvensen.

Set-CMTSStepApplyDriverPackage

Mer information finns i Set-CMTSStepApplyDriverPackage.

Icke-icke-icke-större ändringar

Ett villkor har lagts till för att validera ett paket för angivet PackageId.

Set-CMTSStepApplyOperatingSystem

Mer information finns i Set-CMTSStepApplyOperatingSystem.

Buggar som har åtgärdats

Ett problem med målparametern har åtgärdats.

Icke-icke-icke-större ändringar

Parametern LayeredDriver har lagts till för att stödja tangentbordsdrivrutiner i flera lager under distributionen av operativsystemet.

Set-CMTSStepUpgradeOperatingSystem

Mer information finns i Set-CMTSStepUpgradeOperatingSystem.

Icke-icke-icke-större ändringar

Den nya parametern SoftwareUpdate har lagts till för att ange en funktionsuppdatering för aktivitetssekvenssteget Uppgradera operativsystem.

Start-CMDistributionPointUpgrade

Mer information finns i Start-CMDistributionPointUpgrade.

Icke-bakåtkompatibla ändringar

Ange det minsta lediga standardutrymmet till 500 MB.

Update-CMDistributionPoint

Mer information finns i Update-CMDistributionPoint.

Buggar som har åtgärdats

Åtgärdat ett problem med att uppdatera innehåll från både installations- och avinstallationsmappar när de är olika.

Så här ger du feedback eller rapporterar problem

Många av korrigeringarna och förbättringarna som beskrivs i den här artikeln är resultatet av din feedback.

Om du vill skicka feedback använder Konfigurationshanteraren konsolen. Mer information finns i Feedback för PowerShell.

Information om hur du skickar nya funktionsbegäranden finns i PowerShell-gruppen Konfigurationshanteraren på UserVoice.