Partilhar via

Alterações na Biblioteca Cmdlet do Gestor de Configuração para a versão 2002

  • Artigo

Aplica-se a: Configuration Manager (ramo atual)

Nota

A versão atual do bloco de configuração 1910 é a linha de base para estas alterações. Para obter mais informações, consulte as alterações da Biblioteca Cmdlet do Gestor de Configuração para a versão 1910.

Mudanças importantes

Novos cmdlets

New-CMSoftwareUpdatePhase

Utilize este cmdlet para criar uma fase de implementação para a atualização do software.

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

New-CMTaskSequencePhase

Utilize este cmdlet para criar uma fase de implantação para uma sequência de tarefas.

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

Get-CMPhase

Utilize este cmdlet para obter a fase de implantação para uma instância específica ou uma implantação faseada.

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

New-CMApplicationAutoPhasedDeployment

Utilize este cmdlet para criar uma implementação faseada para uma aplicação gerando duas fases com as mesmas definições.

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

Utilize este cmdlet para criar uma implementação faseada para atualizações de software gerando duas fases com as mesmas definições.

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

Utilize este cmdlet para criar uma implementação faseada para atualizações de software. Terá de adicionar novas fases de implementação personalizadas com o cmdlet New-CMSoftwareUpdatePhase primeiro.

$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

Utilize este cmdlet para criar uma implementação faseada para uma sequência de tarefas gerando duas fases com as mesmas definições.

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

Utilize este cmdlet para criar uma implementação faseada para uma sequência de tarefas. Terá de adicionar novas fases de implementação personalizadas com o cmdlet New-CMTaskSequencePhase primeiro.

$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

Utilize este cmdlet para obter a implementação faseada para uma aplicação.

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

Get-CMSoftwareUpdatePhasedDeployment

Utilize este cmdlet para obter a implementação faseada para atualizações de software.

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

Get-CMTaskSequencePhasedDeployment

Utilize este cmdlet para obter a implantação faseada para uma sequência de tarefas.

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

Get-CMPhasedDeploymentStatus

Utilize este cmdlet para obter o estado de uma implantação faseada específica.

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

Move-CMPhasedDeploymentToNext

Utilize este cmdlet para mover a implantação faseada especificada para a fase seguinte.

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

Resume-CMPhasedDeployment

Utilize este cmdlet para retomar a colocação faseada a partir do estado de suspensão.

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

Suspend-CMPhasedDeployment

Utilize este cmdlet para suspender a implantação faseada especificada.

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

Remove-CMApplicationPhasedDeployment

Utilize este cmdlet para remover uma implementação faseada para uma aplicação.

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

Remove-CMSoftwareUpdatePhasedDeployment

Utilize este cmdlet para remover uma implementação faseada para atualizações de software.

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

Remove-CMTaskSequencePhasedDeployment

Utilize este cmdlet para remover uma implementação faseada para uma sequência de tarefas.

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

Add-CMPassiveSite

Utilize este cmdlet para adicionar um local passivo.

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

Get-CMThirdPartyUpdateCategory

Utilize este cmdlet para obter categorias de atualização de terceiros.

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

Utilize este cmdlet para mover a biblioteca de conteúdos antes de adicionar um site passivo.

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

Set-CMThirdPartyUpdateCategory

Utilize este cmdlet para modificar categorias de atualização de terceiros.

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

Cmdlets preprecados

Nenhuma

Problemas conhecidos

Nenhuma

Alterações do Cmdlet

Foram feitas as seguintes alterações aos cmdlets existentes nesta versão. As alterações podem ser novas funcionalidades, correções de erros ou depreciação. Algumas mudanças podem estar a rebentar. Se utilizar um dos cmdlets ou áreas de funcionalidade listadas nesta secção, reveja cuidadosamente as alterações para entender como podem afetar a sua utilização.

Add-CMDeviceCollectionQueryMembershipRule

Alterações não-quebrando

Adicione mais tratamento de erros para a regra de consulta.

Add-CMMsiDeploymentType

Alterações não-quebrando

Adicione os seguintes novos parâmetros para permitir configurar as opções de comando de reparação e diretório ao criar o tipo de implantação:

  • ReparaçãoCommand
  • ReparaçãoDiresta

Insetos que foram corrigidos

Faltam parâmetros para configurar a opção de comando de reparação e diretório ao criar o tipo de implantação.

Add-CMScriptDeploymentTypes

Alterações interruptivas

A -ContentLocation deixará de aceitar uma pasta vazia.

Insetos que foram corrigidos

A -ContentLocation não deve permitir uma pasta vazia.

Add-CMUserCollectionQueryMembershipRule

Alterações não-quebrando

Adicione mais tratamento de erros para a regra de consulta.

Import-CMSoftwareLicense

Alterações não-quebrando

Fixou um problema de limite de parâmetro para -Timeout.

New-CMApplicationDeployment

Alterações não-quebrando

Adicione o seguinte novo parâmetro para permitir configurar a opção de aplicação de reparação ao criar uma implementação para uma aplicação:

  • AllowRepairApp

Insetos que foram corrigidos

Falta o parâmetro para configurar a opção de aplicação de reparação ao criar a implementação para aplicação.

New-CMSiteSystem

Alterações não-quebrando

Corrigiu a validação para o -SiteSystemServerName e -PublicFqdn.

Insetos que foram corrigidos

Limitação errada para o nome especificado -SiteSystemServerName e -PublicFqdn.

New-CMTSRule

Alterações não-quebrando

O -ReferencedVariableName agora aceita nome variável que começa com sublinhado.

Insetos que foram corrigidos

O -ReferencedVariableName não permite que o utilizador especifique o nome variável que começa com o sublinhado.

Set-CMApplicationDeployment

Alterações não-quebrando

Adicione o seguinte novo parâmetro para permitir configurar a opção de aplicação de reparação quando definir a implementação para uma aplicação:

  • AllowRepairApp

Insetos que foram corrigidos

O parâmetro em falta para configurar a opção de aplicação de reparação quando definido para aplicação.

Set-CMMsiDeploymentType

Alterações não-quebrando

Adicione os seguintes novos parâmetros para permitir configurar opções de comando de reparação e diretório quando definir o tipo de implantação:

  • ReparaçãoCommand
  • ReparaçãoDiresta

Insetos que foram corrigidos

Faltam parâmetros para configurar a opção de comando de reparação e diretório quando definido o tipo de implantação.

Set-CMSite

Alterações não-quebrando

Adicione o seguinte novo parâmetro para permitir que você retry a instalação para um local passivo falhado:

  • RetripinsepassiveSite

Adicione o seguinte novo parâmetro para permitir a promoção de um local passivo para ativo:

  • Promover OMitaVtoActive

Set-CMScriptDeploymentType

Alterações interruptivas

A -ContentLocation deixará de aceitar uma pasta vazia.

Insetos que foram corrigidos

A -ContentLocation não deve permitir uma pasta vazia.

Set-CMThirdPartyUpdateCatalog

Alterações não-quebrando

  • O cmdlet suporta agora a definição de 'Sync Schedule' para um catálogo.
  • Modificou uma chamada de função interna devido a uma mudança de método nativa.
Exemplo
Set-CMThirdPartyUpdateCatalog -Name $name –Schedule $schedule

Como fornecer problemas de feedback ou relatório

Muitas das correções e melhorias descritas neste artigo são resultado do seu feedback.

Para enviar feedback, utilize a consola 'Gestor de Configuração'. Para obter mais informações, consulte feedback para PowerShell.

Para submeter novos pedidos de funcionalidade, consulte o grupo PowerShell do Gestor de Configuração no UserVoice.