alterações da Biblioteca de Cmdlets do Gerenciador de Configurações para a versão 2002

Aplica-se a: Gerenciador de Configurações (branch atual)

Alterações importantes

Novos cmdlets

New-CMSoftwareUpdatePhase

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

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

New-CMTaskSequencePhase

Utilize este cmdlet para criar uma fase de implementaçã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 implementação para uma instância específica ou uma implementaçã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 ao gerar 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 ao gerar 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 ao gerar 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 de 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 implementação faseada para uma sequência de tarefas.

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

Get-CMPhasedDeploymentStatus

Utilize este cmdlet para obter o status de uma implementação faseada específica.

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

Move-CMPhasedDeploymentToNext

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

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

Resume-CMPhasedDeployment

Utilize este cmdlet para retomar a implementação faseada do status de suspensão.

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

Suspend-CMPhasedDeployment

Utilize este cmdlet para suspender a implementaçã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 site 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 preteridos

Nenhum

Problemas conhecidos

Nenhum

Alterações de cmdlets

Foram efetuadas as seguintes alterações aos cmdlets existentes nesta versão. As alterações podem ser novas funcionalidades, correções de erros ou preterição. Algumas alterações podem estar a falhar. Se utilizar um dos cmdlets ou áreas de funcionalidade listados nesta secção, reveja cuidadosamente as alterações para compreender como podem afetar a sua utilização.

Add-CMDeviceCollectionQueryMembershipRule

Alterações não interruptivas

Foi adicionado mais processamento de erros para a regra de consulta.

Add-CMMsiDeploymentType

Alterações não interruptivas

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

• Comando reparar
• RepairWorkingDirectory

Erros que foram corrigidos

Parâmetros em falta para configurar o comando de reparação e a opção de diretório ao criar o tipo de implementação.

Add-CMScriptDeploymentTypes

Alterações interruptivas

O -ContentLocation deixará de aceitar uma pasta vazia.

Erros que foram corrigidos

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

Add-CMUserCollectionQueryMembershipRule

Alterações não interruptivas

Foi adicionado mais processamento de erros para a regra de consulta.

Import-CMSoftwareLicense

Alterações não interruptivas

Foi corrigido um problema de delimitação de parâmetros para -Timeout.

New-CMApplicationDeployment

Alterações não interruptivas

Foi adicionado o novo parâmetro seguinte para permitir configurar a opção reparar a aplicação ao criar uma implementação para uma aplicação:

• AllowRepairApp

Erros que foram corrigidos

Parâmetro em falta para configurar a opção reparar a aplicação ao criar a implementação para a aplicação.

New-CMSiteSystem

Alterações não interruptivas

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

Erros que foram corrigidos

Limitação incorreta para -SiteSystemServerName e -PublicFqdn especificados.

New-CMTSRule

Alterações não interruptivas

O -ReferencedVariableName aceita agora o nome da variável que começa com o caráter de sublinhado.

Erros que foram corrigidos

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

Set-CMApplicationDeployment

Alterações não interruptivas

Foi adicionado o novo parâmetro seguinte para permitir configurar a opção reparar a aplicação quando definir a implementação para uma aplicação:

• AllowRepairApp

Erros que foram corrigidos

Parâmetro em falta para configurar a opção reparar a aplicação ao definir a implementação para a aplicação.

Set-CMMsiDeploymentType

Alterações não interruptivas

Foram adicionados os seguintes novos parâmetros para lhe permitir configurar opções de comando de reparação e de diretório ao definir o tipo de implementação:

• Comando reparar
• RepairWorkingDirectory

Erros que foram corrigidos

Parâmetros em falta para configurar o comando de reparação e a opção de diretório ao definir o tipo de implementação.

Set-CMSite

Alterações não interruptivas

Foi adicionado o novo parâmetro seguinte para permitir que repita a instalação de um site passivo com falha:

• RetryInstallPassiveSite

Foi adicionado o novo parâmetro seguinte para permitir a promoção de um site passivo para ativo:

• PromotePassiveSiteToActive

Set-CMScriptDeploymentType

Alterações interruptivas

O -ContentLocation deixará de aceitar uma pasta vazia.

Erros que foram corrigidos

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

Set-CMThirdPartyUpdateCatalog

Alterações não interruptivas

• O cmdlet suporta agora a definição "Agenda de Sincronização" para um catálogo.
• Modificou uma chamada de função interna devido a uma alteração do método nativo.

Exemplo

Set-CMThirdPartyUpdateCatalog -Name $name –Schedule $schedule