Condividi tramite

Configuration Manager modifiche alla libreria dei cmdlet per la versione 2002

  • Articolo

Si applica a: Configuration Manager (Current Branch)

Nota

Configuration Manager current branch versione 1910 è la linea di base per queste modifiche. Per altre informazioni, vedere Configuration Manager modifiche alla libreria dei cmdlet per la versione 1910.

Modifiche importanti

Nuovi cmdlet

New-CMSoftwareUpdatePhase

Usare questo cmdlet per creare una fase di distribuzione per l'aggiornamento software.

New-CMSoftwareUpdatePhase `
 -CollectionName "MyCollection" `
 -PhaseName "MySUPhase"`
 -UserNotificationOption DisplaySoftwareCenterOnly

New-CMTaskSequencePhase

Usare questo cmdlet per creare una fase di distribuzione per una sequenza di attività.

New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true

Get-CMPhase

Usare questo cmdlet per ottenere la fase di distribuzione per un'istanza specifica o una distribuzione in più fasi.

Get-CMPhase -Id "66DEDF86-D0CB-457D-88BE-47E3FAC92A47"
$myPhasedDeployment | Get-CMPhase

New-CMApplicationAutoPhasedDeployment

Usare questo cmdlet per creare una distribuzione in più fasi per un'applicazione generando due fasi con le stesse impostazioni.

New-CMApplicationAutoPhasedDeployment -ApplicationName "myApp" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
 
$myApp | New-CMApplicationAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

New-CMSoftwareUpdateAutoPhasedDeployment

Usare questo cmdlet per creare una distribuzione in più fasi per gli aggiornamenti software generando due fasi con le stesse impostazioni.

New-CMSoftwareUpdateAutoPhasedDeployment -SoftwareUpdateName "myUpdateName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
$myUpdate | New-CMSoftwareUpdateAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

New-CMSoftwareUpdateManualPhasedDeployment

Usare questo cmdlet per creare una distribuzione in più fasi per gli aggiornamenti software. È necessario aggiungere prima nuove fasi di distribuzione personalizzate con il cmdlet New-CMSoftwareUpdatePhase.

$phase1 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test01" -UserNotificationOption DisplaySoftwareCenterOnly
$phase2 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test02" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateNames ("myUpdateA", "myUpdateB") -Name "myPhaseDeployment" -AddPhases ($phase1, $phase2)
 
$phase3 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test03" -UserNotificationOption DisplaySoftwareCenterOnly
$phase4 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test04" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateGroupName "myGroup" -Name "myPhaseDeploymentForGroup" -AddPhases ($phase3, $phase4)

New-CMTaskSequenceAutoPhasedDeployment

Usare questo cmdlet per creare una distribuzione in più fasi per una sequenza di attività generando due fasi con le stesse impostazioni.

New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
 
$myTS | New-CMTaskSequenceAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

New-CMTaskSequenceManualPhasedDeployment

Usare questo cmdlet per creare una distribuzione in più fasi per una sequenza di attività. È necessario aggiungere prima nuove fasi di distribuzione personalizzate con il cmdlet New-CMTaskSequencePhase.

$phase1 = New-CMTaskSequencePhase -CollectionId "SMSDM001" -PhaseName "test01" -UserNotification DisplayAll
$phase2 = New-CMTaskSequencePhase -CollectionId "SMSDM003" -PhaseName "test02" -UserNotification HideAll
New-CMTaskSequenceManualPhasedDeployment -TaskSequenceName "myTaskSequence" -Name "phasedDeployment" -AddPhases ($phase1, $phase2)
 
$phase3 = New-CMTaskSequencePhase -CollectionId "SMSDM001" -PhaseName "test03" -UserNotification DisplayAll
$phase4 = New-CMTaskSequencePhase -CollectionId "SMSDM003" -PhaseName "test04" -UserNotification HideAll
$myTaskSequence | New-CMTaskSequenceManualPhasedDeployment -Name "phasedDeployment" -AddPhases ($phase3, $phase4)

Get-CMApplicationPhasedDeployment

Usare questo cmdlet per ottenere la distribuzione in più fasi per un'applicazione.

Get-CMApplicationPhasedDeployment -Name "myPhasedDeploymentName"
 
Get-CMApplicationPhasedDeployment -ApplicationName "myApplicationName"

Get-CMSoftwareUpdatePhasedDeployment

Usare questo cmdlet per ottenere la distribuzione in più fasi per gli aggiornamenti software.

Get-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeploymentName"
 
Get-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateName "myUpdateName"

Get-CMTaskSequencePhasedDeployment

Usare questo cmdlet per ottenere la distribuzione in più fasi per una sequenza di attività.

Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeploymentName"
 
Get-CMTaskSequencePhasedDeployment -TaskSequenceName "myTaskSequenceName"

Get-CMPhasedDeploymentStatus

Usare questo cmdlet per ottenere lo stato di una distribuzione in più fasi specifica.

Get-CMPhasedDeploymentStatus -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Get-CMPhasedDeploymentStatus -Catalog $catalog

Move-CMPhasedDeploymentToNext

Usare questo cmdlet per spostare la distribuzione in più fasi specificata nella fase successiva.

Move-CMPhasedDeploymentToNext -Name "myPhasedDeploymentName"  
 
$myPhasedDeployment | Move-CMPhasedDeploymentToNext -Force

Resume-CMPhasedDeployment

Usare questo cmdlet per riprendere la distribuzione in più fasi dallo stato di sospensione.

Resume-CMPhasedDeployment -Name "myPhasedDeploymentName"  
 
$myPhasedDeployment | Resume-CMPhasedDeployment -Force

Suspend-CMPhasedDeployment

Usare questo cmdlet per sospendere la distribuzione in più fasi specificata.

Suspend-CMPhasedDeployment -Name "myPhasedDeploymentName"
  
$myPhasedDeployment | Suspend-CMPhasedDeployment -Force

Remove-CMApplicationPhasedDeployment

Usare questo cmdlet per rimuovere una distribuzione in più fasi per un'applicazione.

Remove-CMApplicationPhasedDeployment -ApplicationName "myApplicationName"
 
Remove-CMApplicationPhasedDeployment -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Remove-CMApplicationPhasedDeployment -Force

Remove-CMSoftwareUpdatePhasedDeployment

Usare questo cmdlet per rimuovere una distribuzione in più fasi per gli aggiornamenti software.

Remove-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateName "mySoftwareUpdateName"
 
Remove-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateGroupName "mySoftwareUpdateGroupName"
 
Remove-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Remove-CMSoftwareUpdatePhasedDeployment -Force

Remove-CMTaskSequencePhasedDeployment

Usare questo cmdlet per rimuovere una distribuzione in più fasi per una sequenza di attività.

Remove-CMTaskSequencePhasedDeployment -TaskSequenceName "myTaskSequenceName"
 
Remove-CMTaskSequencePhasedDeployment -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Remove-CMTaskSequencePhasedDeployment -Force

Add-CMPassiveSite

Usare questo cmdlet per aggiungere un sito passivo.

Add-CMPassiveSite -InputObject $SiteSystem -InstallDirectory $InstallPath -SourceFilePathOption CopySourceFileFromActiveSite
Add-CMPassiveSite -SiteCode $SiteCode -SiteSystemServerName $SiteSystemServerName -InstallDirectory $InstallPath -SourceFilePathOption UseLocalSourceDirectory -LocalSourceDirectory $LocalSourcePath

Get-CMThirdPartyUpdateCategory

Usare questo cmdlet per ottenere categorie di aggiornamento di terze parti.

Get-CMThirdPartyUpdateCategory
Get-CMThirdPartyUpdateCategory -Catalog $catalog
Get-CMThirdPartyUpdateCategory -CatalogId $catalogId -Id $categoryId
Get-CMThirdPartyUpdateCategory -CatalogName $catalogName -Name $categoryName
$catalog | Get-CMThirdPartyUpdateCategory -ParentId $parentId -PublishOption $publishOption

Move-CMContentLibrary

Usare questo cmdlet per spostare la raccolta contenuto prima di aggiungere un sito passivo.

Move-CMContentLibrary -InputObject $Site -NewLocation $NewLocationPath
Move-CMContentLibrary -SiteCode $SiteCode -NewLocation $NewLocationPath

Set-CMThirdPartyUpdateCategory

Usare questo cmdlet per modificare le categorie di aggiornamento di terze parti.

Set-CMThirdPartyUpdateCategory -Catalog $catalog -Id $categoryId -PublishOption $publishOption -EnableCategories $true
$catalog | Set-CMThirdPartyUpdateCategory -Name $categoryName -PublishOption $publishOption -EnableCategories $true
Set-CMThirdPartyUpdateCategory -CatalogId $catalogId -ParentId $parentId -PublishOption $publishOption -EnableCategories $true
Set-CMThirdPartyUpdateCategory -CatalogName $catalogName -Name $categoryName -ParentId $parentId -PublishOption $publishOption -EnableCategories $true
Set-CMThirdPartyUpdateCategory -Categories $categories -PublishOption $publishOption -EnableCategories $true

Cmdlet deprecati

Nessuno

Problemi noti

Nessuno

Modifiche ai cmdlet

In questa versione sono state apportate le modifiche seguenti ai cmdlet esistenti. Le modifiche possono essere nuove funzionalità, correzioni di bug o deprecazione. Alcune modifiche potrebbero causare un'interruzione. Se si usa una delle aree dei cmdlet o delle funzionalità elencate in questa sezione, esaminare attentamente le modifiche per comprendere in che modo possono influire sull'uso.

Add-CMDeviceCollectionQueryMembershipRule

Modifiche non di rilievo

Aggiunta di altre operazioni di gestione degli errori per la regola di query.

Add-CMMsiDeploymentType

Modifiche non di rilievo

Sono stati aggiunti i nuovi parametri seguenti per consentire di configurare il comando di ripristino e le opzioni della directory durante la creazione del tipo di distribuzione:

  • RepairCommand
  • RepairWorkingDirectory

Bug corretti

Parametri mancanti per configurare il comando di ripristino e l'opzione della directory durante la creazione del tipo di distribuzione.

Add-CMScriptDeploymentTypes

Modifiche di rilievo

-ContentLocation non accetterà più una cartella vuota.

Bug corretti

-ContentLocation non deve consentire una cartella vuota.

Add-CMUserCollectionQueryMembershipRule

Modifiche non di rilievo

Aggiunta di altre operazioni di gestione degli errori per la regola di query.

Import-CMSoftwareLicense

Modifiche non di rilievo

Correzione di un problema di delimitazione dei parametri per -Timeout.

New-CMApplicationDeployment

Modifiche non di rilievo

È stato aggiunto il nuovo parametro seguente per consentire di configurare l'opzione di ripristino dell'applicazione durante la creazione di una distribuzione per un'applicazione:

  • AllowRepairApp

Bug corretti

Parametro mancante per configurare l'opzione di ripristino dell'applicazione durante la creazione della distribuzione per l'applicazione.

New-CMSiteSystem

Modifiche non di rilievo

Correzione della convalida per -SiteSystemServerName e -PublicFqdn.

Bug corretti

Limitazione errata per le proprietà -SiteSystemServerName e -PublicFqdn specificate.

New-CMTSRule

Modifiche non di rilievo

Il -ReferencedVariableName accetta ora il nome della variabile che inizia con il carattere di sottolineatura.

Bug corretti

-ReferencedVariableName non consente all'utente di specificare il nome della variabile che inizia con il carattere di sottolineatura.

Set-CMApplicationDeployment

Modifiche non di rilievo

È stato aggiunto il nuovo parametro seguente per consentire di configurare l'opzione dell'applicazione di ripristino quando si imposta la distribuzione per un'applicazione:

  • AllowRepairApp

Bug corretti

Parametro mancante per configurare l'opzione di ripristino dell'applicazione quando si imposta la distribuzione per l'applicazione.

Set-CMMsiDeploymentType

Modifiche non di rilievo

Sono stati aggiunti i nuovi parametri seguenti per consentire di configurare le opzioni di comando di ripristino e directory quando si imposta il tipo di distribuzione:

  • RepairCommand
  • RepairWorkingDirectory

Bug corretti

Parametri mancanti per configurare il comando di ripristino e l'opzione della directory quando si imposta il tipo di distribuzione.

Set-CMSite

Modifiche non di rilievo

È stato aggiunto il nuovo parametro seguente per consentire di ritentare l'installazione per un sito passivo non riuscito:

  • RetryInstallPassiveSite

È stato aggiunto il nuovo parametro seguente per consentire di alzare di livello un sito passivo a attivo:

  • PromotePassiveSiteToActive

Set-CMScriptDeploymentType

Modifiche di rilievo

-ContentLocation non accetterà più una cartella vuota.

Bug corretti

-ContentLocation non deve consentire una cartella vuota.

Set-CMThirdPartyUpdateCatalog

Modifiche non di rilievo

  • Il cmdlet supporta ora l'impostazione di "Pianificazione sincronizzazione" per un catalogo.
  • Modifica di una chiamata di funzione interna a causa di una modifica del metodo nativa.
Esempio
Set-CMThirdPartyUpdateCatalog -Name $name –Schedule $schedule