Alterações na biblioteca cmdlet do Gestor de Configuração para a versão 2010

  • Artigo

Aplica-se a: Gestor de Configuração (ramo atual)

Estas notas de lançamento resumem as alterações à biblioteca cmdlet do Gestor de Configuração na versão 2010.

A partir da versão 2010, a biblioteca cmdlet PowerShell do Gestor de Configuração oferece agora suporte para PowerShell 7. Para obter mais informações, consulte Suporte para powerShell versão 7.

Nota

A versão atual do bloco de configuração 2002 é 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 2006.

Gateway de gestão da cloud

Com mais clientes a gerir dispositivos remotos agora, esta versão inclui vários cmdlets novos e melhorados do Windows PowerShell para o gateway de gestão de nuvem (CMG). Pode utilizar estes cmdlets para automatizar a criação, configuração e gestão dos requisitos do serviço CMG e do Azure Ative Directory (Azure AD).

Nota

Embora alguns dos novos cmdlets possam funcionar com outros serviços Azure, eles só são testados com a ligação de gestão Cloud para suportar o CMG.

Por exemplo, um administrador da Azure cria primeiro as duas aplicações necessárias no Azure Ative Directory (Azure AD). Em seguida, escreve-se um script que utiliza os seguintes cmdlets para implantar um CMG:

  1. Import-CMAADServerApplicação: Criar a definição de aplicação de servidor AD Azure no Gestor de Configuração.
  2. Import-CMAADClientApplicação: Criar a definição de aplicação de cliente AD AZure no Gestor de Configuração.
  3. Utilize o Get-CMAADApplication para obter os objetos da aplicação e, em seguida, passe para New-CMCloudManagementAzureService para criar a ligação de serviço Azure no Gestor de Configuração.
  4. New-CMCloudManagementGateway: Criar o serviço CMG em Azure.
  5. Add-CMCloudManagementGatewayConnectionPoint: Criar o sistema de site de ponto de ligação CMG.

Novos cmdlets para CMG

Cmdlets atualizados para CMG

Os cmdlets existentes têm melhorias significativas. Para obter mais informações, consulte as seguintes notas de lançamento:

Cmdlets existentes para CMG

Pode continuar a utilizar os seguintes cmdlets CMG existentes:

Novos cmdlets

Gestão de aplicações

Gestão de cobranças

Atualização de edição do Windows 10

Perfis de navegador do Microsoft Edge

OneDrive para perfis de negócios

Cmdlets preprecados e removidos

Os seguintes cmdlets para ambientes híbridos do Gestor de Configuração já não estão disponíveis:

  • Add-CMAndroidDeploymentType
  • Add-CMGooglePlayDeploymentType
  • Add-CMIosAppStoreDeploymentType
  • Add-CMIosDeploymentType
  • Set-CMAndroidDeploymentType
  • Set-CMGooglePlayDeploymentType
  • Set-CMIosAppStoreDeploymentType
  • Set-CMIosDeploymentType

Para mais informações, veja o que aconteceu com o MDM híbrido?

O cmdlet seguinte é depreciado:

Problemas conhecidos

Nenhum

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-CMComplianceSettingRegistryKeyValue

Para obter mais informações, consulte Add-CMComplianceSettingRegistryKeyValue.

Alterações não-quebrando

Parâmetro ExpectValue pode aceitar um valor vazio.

Add-CMDistributionPoint

Para obter mais informações, consulte Add-CMDistributionPoint.

Insetos que foram corrigidos

Corrigiu um problema para a criação de pontos de distribuição.

Add-CMDeviceCollectionDirectMembershipRule

Para mais informações, consulte Add-CMDeviceCollectionDirectMembershipRule.

Insetos que foram corrigidos

Corrigiu um problema para verificação do número do dispositivo duplicado.

Add-CMManagementPoint

Para mais informações, consulte Add-CMManagementPoint.

Insetos que foram corrigidos

Corrigi um problema para o suporte de gateway de gestão de nuvens.

Add-CMPassiveSite

Para mais informações, consulte Add-CMPassiveSite.

Insetos que foram corrigidos

Corrigiu um problema para o local passivo na hierarquia.

Add-CMTaskSequenceStep

Para obter mais informações, consulte Add-CMTaskSequenceStep.

Insetos que foram corrigidos

Corrigiu um problema de tamanho de política ao utilizar vários passos PowerShell que contêm scripts grandes.

Add-CMWindowsAppxDeploymentType

Para obter mais informações, consulte Add-CMWindowsAppxDeploymentType.

Alterações não-quebrando

Função adicional para suporte MSIX.

Approve-CMDevice

Para obter mais informações, consulte Approve-CMDevice.

Alterações não-quebrando

Corrigiu um problema ao trabalhar com a Get-CMDevice.

Enable-CMSiteFeature

Para obter mais informações, consulte Enable-CMSiteFeature.

Alterações não-quebrando

Adicione novas bandeiras para suportar as características da nuvem.

Get-CMScript

Para obter mais informações, consulte Get-CMScript.

Alterações não-quebrando

Adicione novo parâmetro ScriptGuid para suportar consulta pelo script GUID.

Get-CMSiteFeature

Para mais informações, consulte a Get-CMSiteFeature.

Alterações não-quebrando

Adicione novas bandeiras para suportar as características da nuvem.

Get-CMSoftwareUpdate

Para mais informações, consulte Get-CMSoftwareUpdate.

Alterações não-quebrando

Adicione novo parâmetro Fornecedor para especificar a origem da atualização do software.

Exemplo:

Get-CMSoftwareUpdate -Name $Update -Vendor "Microsoft"

Get-CMStatusMessageQuery

Para mais informações, consulte Get-CMStatusMessageQuery.

Insetos que foram corrigidos

Corrigiu um problema para o parâmetro ShowMessage.

Import-CMDriver

Para mais informações, consulte Import-CMDriver.

Alterações não-quebrando

Adicionou novo parâmetro AdministrativeCategoryName para especificar um nome para a categoria de condutor.

Exemplo:

Import-CMDriver -UncFileLocation $DriverFolder -ImportFolder -ImportDuplicateDriverOption AppendCategory -AdministrativeCategory "Video drivers"

Invoke-CMAnalyzePackage

Para mais informações, consulte Invoke-CMAnalyzePackage.

Alterações interruptivas

Parâmetro do pacote removido. Encaneie o objeto de embalagem ou utilize o parâmetro InputObject.

Alterações não-quebrando

Suporte ao gasoduto adicionado e o parâmetro InputObject.

Exemplo:

$pkg | Invoke-CMAnalyzePackage

Invoke-CMClientAction

Para obter mais informações, consulte Invoke-CMClientAction.

Insetos que foram corrigidos

Problema de gasoduto fixo para a recolha de parâmetros.

Exemplo:

Get-CMCollection -Name "deviceCol1" | Invoke-CMClientAction -ActionType ClientNotificationRequestUsersPolicyNow

Invoke-CMConvertPackage

Para mais informações, consulte Invoke-CMConvertPackage.

Alterações interruptivas

Parâmetro do pacote removido. Encaneie o objeto de embalagem ou utilize o parâmetro InputObject.

Alterações não-quebrando

Suporte ao gasoduto adicionado e o parâmetro InputObject.

Exemplo:

$pkg | Invoke-CMConvertPackage

Invoke-CMReport

Para mais informações, consulte Invoke-CMReport.

Insetos que foram corrigidos

Corrigiu um problema para o caminho do parâmetro.

Invoke-CMScript

Para obter mais informações, consulte Invoke-CMScript.

Alterações não-quebrando

Adicione o parâmetro ScriptParameter para passar parâmetros para o script alvo.

Exemplo:

$Hash = @{"FolderName"="c:\test\test1"; "FileName"="test2"}

Invoke-CMScript -ScriptGuid $scriptGuid -Device (Get-CMDevice -Name $targetPCName) -ScriptParameter $Hash

New-CMBMSClientConfigureCheckIntervalPolicy

Para mais informações, consulte New-CMBMSClientConfigureCheckIntervalPolicy.

Insetos que foram corrigidos

Corrigiu um problema ao criar uma nova instância de definição de políticas.

New-CMBoundary

Para mais informações, consulte New-CMBoundary.

Alterações não-quebrando

Opção VPN adicionada no parâmetro BoundaryType.

New-CMBootableMedia

Para mais informações, consulte New-CMBootableMedia.

Alterações não-quebrando

Adicionar parâmetro SiteCode.

New-CMCloudManagementGateway

Para mais informações, consulte New-CMCloudManagementGateway.

Alterações não-quebrando

Os seguintes parâmetros são novos:

  • CARootCert
  • AtivarCloudDPFunction
  • AtivartorageQuota
  • EnableTrafficOut
  • EnforceProtocol
  • Force
  • Nome do Grupo
  • IsUsingExistingGroup
  • ServerAppClientID
  • ServiceCertPassword
  • ServiceCertPath
  • ServiceName
  • StorageCriticalPct
  • ArmazenamentoQuotaGB
  • ArmazenamentoWarningPct
  • TrafficOutStopService

São atualizados os seguintes parâmetros:

  • CheckClientCertRevocation
  • AmbienteSetting
  • Region
  • SubscriptionId
  • TrafficCriticalPct
  • TrafficWarningPct

Alterações interruptivas

São removidos os seguintes parâmetros deste cmdlet:

  • Assinatura do Governo
  • ManagementCertatePassword
  • ManagementCertificatePath
  • PassThru
  • RootCertificatePath
  • ServiceCertatepassword
  • ServiceCertificatePath
  • Nome de serviço

New-CMCoManagementPolicy

Para mais informações, consulte a New-CMCoManagementPolicy.

Alterações não-quebrando

Aplicabilidade multi-sessão adicionada

Aplicabilidade adição DE ARM64

New-CMComplianceRuleFileFolderDate

Para mais informações, consulte New-CMComplianceRuleFileFolderDate.

Alterações não-quebrando

Ajustou a lógica do cmdlet para processar os valores a partir de parâmetros Modificação e Criação para alinhar com outros cmdlets.

New-CMComplianceRuleFileFolderSimple

Para mais informações, consulte New-CMComplianceRuleFileFolderSimple.

Alterações interruptivas

Alterou o tipo de parâmetro PropertyType de FileFolderProperty para SimpleFileFolderProperty type.

New-CMDetectionClauseDirectory

Para obter mais informações, consulte o Novo CmDetectionClauseDirectory.

Alterações interruptivas

Alterou o tipo de parâmetro ExpressionOperator de RuleExpressionOperator para FileFolderRuleExpressionOperator.

New-CMDetectionClauseFile

Para mais informações, consulte New-CMDetectionClauseFile.

Alterações interruptivas

Alterou o tipo de parâmetro ExpressionOperator de RuleExpressionOperator para FileFolderRuleExpressionOperator.

New-CMDetectionClauseMacBundle

Para obter mais informações, consulte New-CMDetectionClauseMacBundle.

Alterações interruptivas

Alterou o tipo de parâmetro ExpressionOperator do Tipo RuleExpressionOperator para MacRuleExpressionOperator.

Insetos que foram corrigidos

Corrigiu um problema para o parâmetro PropertyType.

New-CMDetectionClauseMacPackage

Para obter mais informações, consulte New-CMDetectionClauseMacPackage.

Alterações interruptivas

Alterou o tipo de parâmetro ExpressionOperator do Tipo RuleExpressionOperator para MacRuleExpressionOperator.

New-CMDetectionClauseRegistryKeyValue

Para obter mais informações, consulte New-CMDetectionClauseRegistryKeyValue.

Alterações interruptivas

Alterou o tipo de parâmetro ExpressionOperator de RuleExpressionOperator para RegistryValueRuleExpressionOpero tipo.

New-CMDetectionClauseWindowsInstaller

Para obter mais informações, consulte New-CMDetectionClauseWindowsInstaller.

Alterações interruptivas

Alterou o tipo de parâmetro ExpressionOperator de RuleExpressionOperator para WindowsInstallerRuleExpressionOperator.

New-CMDriverPackage

Para mais informações, consulte New-CMDriverPackage.

Insetos que foram corrigidos

Corrigiu um problema para o modelo DriverModel.

Novo CM*Deploração faseada

Para obter mais informações, veja os seguintes artigos:

Insetos que foram corrigidos

Corrigiu um problema para o parâmetro WhatIf.

Alterações não-quebrando

Validação adicionada para nome de fase duplicada.

New-CMPrestageMedia

Para mais informações, consulte New-CMPrestageMedia.

Alterações não-quebrando

Adicionar parâmetro SiteCode.

New-CMProgram

Para mais informações, consulte o Novo CMPrograma.

Alterações interruptivas

Renomeado o tipo RenameWithUnc RunWithUnc para parâmetro DriveMode.

New-CMSoftwareUpdateDeployment

Para mais informações, consulte New-CMSoftwareUpdateDeployment.

Alterações não-quebrando

Adicionou novo parâmetro ImplementarWithNoPackage para atualização de software não descarregada.

New-CMStandaloneMedia

Para mais informações, consulte New-CMStandaloneMedia.

Insetos que foram corrigidos

Corrigiu um problema para o parâmetrotPackage

New-CMTaskSequence

Para mais informações, consulte New-CMTaskSequence.

Insetos que foram corrigidos

Corrigiu um problema de tamanho de política quando utilizar vários passos PowerShell que contêm scripts grandes.

New-CMTaskSequenceDeployment

Para mais informações, consulte New-CMTaskSequenceDeployment.

Insetos que foram corrigidos

Corrigiu um problema para o parâmetro AllowFallback.

Alterações não-quebrando

Validação adicional para parâmetro Agenda para evitar valor duplicado com a atribuição existente.

New-CMTaskSequenceMedia

Para mais informações, consulte New-CMTaskSequenceMedia.

Alterações não-quebrando

Mudou o tempo na criação dos media de um dia para três dias.

New-CMTSPartitionSetting

Para mais informações, consulte a New-CMTSPartitionSetting.

Insetos que foram corrigidos

Corrigiu um problema para o parâmetro EnableQuickFormat.

New-CMTSStepEnableBitLocker

Para mais informações, consulte New-CMTSStepEnableBitLocker.

Insetos que foram corrigidos

Corrigiu um problema para o método de encriptação especificado pelo utilizador.

New-CMTSStepOfflineEnableBitLocker

Para mais informações, consulte New-CMTSStepOfflineEnableBitLocker.

Insetos que foram corrigidos

Corrigiu um problema para o método de encriptação especificado pelo utilizador.

New-CMTSStepPreStartCheck

Para mais informações, consulte New-CMTSStepPreStartCheck.

Insetos que foram corrigidos

Corrigi um problema para novo passo de prontidão de verificação.

Corrigiu um problema para o parâmetro OSLanguageId.

Alterações não-quebrando

Adicione um novo parâmetro para verificação UEFI, CheckUefi.

Remove-CMTaskSequenceGroup

Para obter mais informações, consulte Remove-CMTaskSequenceGroup.

Insetos que foram corrigidos

Corrigiu um problema de tamanho de política quando utilizar vários passos PowerShell que contêm scripts grandes.

Set-CM*Deploração faseada

Para obter mais informações, veja os seguintes artigos:

Insetos que foram corrigidos

Corrigiu um problema para o parâmetro WhatIf.

Set-CMBoundary

Para obter mais informações, consulte Set-CMBoundary.

Alterações não-quebrando

Opção adicionada VPN no BoundaryType.

Set-CMClientSettingComputerRestart

Para obter mais informações, consulte Set-CMClientSettingComputerRestart.

Alterações não-quebrando

Adicionei um novo parâmetro NoRebootEnforce.

Set-CMClientSettingSoftwareUpdate

Para obter mais informações, consulte Set-CMClientSettingSoftwareUpdate.

Alterações não-quebrando

Parâmetros adicionados:

  • Ativação ativa
  • ThreadPriority
  • EnableDynamicUpdate

Exemplo:

Set-CMClientSettingSoftwareUpdate -InputObject $testsetting -Enable $true -ScanSchedule $Sch1 -DeploymentEvaluationSchedule $Sch2 -BatchingTimeout 3 -TimeUnit Days -EnforceMandatory $true -Office365ManagementType $false -EnableThirdPartyUpdates $true -EnableDeltaDownload $true -EnableInstallation $true -ThreadPriority Normal -EnableDynamicUpdate $true

Set-CMCloudManagementGateway

Para mais informações, consulte Set-CMCloudManagementGateway.

Alterações não-quebrando

Os seguintes parâmetros são novos:

  • CARootCert
  • AtivarCloudDPFunction
  • AtivartorageQuota
  • EnableTrafficOut
  • EnforceProtocol
  • Remover Impressões DeCertThumb
  • StorageCriticalPct
  • ArmazenamentoQuotaGB
  • ArmazenamentoWarningPct
  • TrafficOutStopService
  • VMInstanceCount

Alterações interruptivas

São removidos os seguintes parâmetros deste cmdlet:

  • VMInstancesCount

Set-CMDiscoveryMethod

Para obter mais informações, consulte Set-CMDiscoveryMethod.

Insetos que foram corrigidos

Corrigiu um problema para o parâmetro AddGroupDiscoveryScope.

Set-CMDistributionPoint

Para obter mais informações, consulte Set-CMDistributionPoint.

Alterações não-quebrando

Parâmetros adicionados para suportar a Cache Conectada do Microsoft:

  • AtivarDoinc
  • DiskSpaceUnit
  • DiskSpaceDoinc
  • LocalDriveDoinc
  • RetençãoDoincCache
  • ConcordarDoincLicense

Exemplo:

$dp | Set-CMDistributionPoint -EnableDoinc $true -AgreeDoincLicense $true

$dp | Set-CMDistributionPoint -RetainDoincCache $true -EnableDoinc $true -AgreeDoincLicense $true

$dp | Set-CMDistributionPoint -LocalDriveDoinc "Z:" -DiskSpaceDoinc 9000 -DiskSpaceUnit GB

Set-CMDriverPackage

Para obter mais informações, consulte Set-CMDriverPackage.

Insetos que foram corrigidos

Corrigiu um problema para o modelo DriverModel.

Set-CMManagementPoint

Para obter mais informações, consulte Set-CMManagementPoint.

Insetos que foram corrigidos

Corrigi um problema para o suporte de gateway de gestão de nuvens.

Set-CMProgram

Para obter mais informações, consulte Set-CMProgram.

Alterações interruptivas

Renomeado o tipo RenameWithUnc RunWithUnc para parâmetro DriveMode.

Set-CMSiteMaintenanceTask

Para obter mais informações, consulte Set-CMSiteMaintenanceTask.

Alterações não-quebrando

Adicione os seguintes novos parâmetros para configurar o destino de backup do Site e o destino de backup SQL para ambientes com um fornecedor de SMS remoto:

  • SiteBackupPath
  • SqlBackupPath

Exemplo:

Set-CMSiteMaintenanceTask -Name $TaskName  -SiteBackupPath "c:\site-backup" -SqlBackupPath "c:\sql-backup" -BeginTime (Get-Date) -DaysOfWeek Sunday,Monday -EnableAlert $true -Enabled $true

Set-CMSoftwareUpdateAutoDeploymentRule

Para obter mais informações, consulte Set-CMSoftwareUpdateAutoDeploymentRule.

Insetos que foram corrigidos

Corrigiu um problema para o objeto de entrada da Get-CMSoftwareUpdateAutoDeploymentRule com opção Fast.

Set-CMSoftwareUpdateDeploymentPackage

Para obter mais informações, consulte Set-CMSoftwareUpdateDeploymentPackage.

Insetos que foram corrigidos

Corrigiu um problema para os parâmetros RemoveExpired e RemoveSuperceded.

Set-CMSoftwareUpdateGroup

Para mais informações, consulte Set-CMSoftwareUpdateGroup.

Insetos que foram corrigidos

Corrigi um problema para adicionar atualização de software não descarregada.

Set-CMStatusFilterRule

Para obter mais informações, consulte Set-CMStatusFilterRule.

Insetos que foram corrigidos

Corrigiu um problema para o parâmetro Name para se certificar de que é composto por Get-CMStatusFilterRule.

Set-CMTaskSequenceDeployment

Para obter mais informações, consulte Set-CMTaskSequenceDeployment.

Insetos que foram corrigidos

Corrigiu um problema para o parâmetro ScheduleEvent.

Corrigiu um problema para o parâmetro AllowFallback.

Alterações não-quebrando

Validação adicional para parâmetro Agenda para evitar valor duplicado com a atribuição existente.

Adicionou novos parâmetros à configuração da programação:

  • ClearSchedule
  • RemoverSchedule
  • AddSchedule

Adicionou novos parâmetros à configuração ScheduleEvent:

  • ClearScheduleEvent
  • RemoveScheduleEvent
  • AddScheduleEvent

Exemplo:

$ReferenceDeployment | Set-CMTaskSequenceDeployment -AddSchedule $schedule1, $schedule2

$ReferenceDeployment | Set-CMTaskSequenceDeployment -AddScheduleEvent LogOn, LogOff

Set-CMTSStep*

Insetos que foram corrigidos

Corrigiu um problema de tamanho de política quando utilizar vários passos PowerShell que contêm scripts grandes.

Set-CMTSStepEnableBitLocker

Para mais informações, consulte Set-CMTSStepEnableBitLocker.

Insetos que foram corrigidos

Corrigiu um problema para o método de encriptação especificado pelo utilizador.

Set-CMTSStepOfflineEnableBitLocker

Para obter mais informações, consulte Set-CMTSStepOfflineEnableBitLocker.

Insetos que foram corrigidos

Corrigiu um problema para o método de encriptação especificado pelo utilizador.

Set-CMTSStepPreStartCheck

Para mais informações, consulte Set-CMTSStepPreStartCheck.

Alterações não-quebrando

Adicionei um novo parâmetro para verificação UEFI:, CheckUefi.

Set-CMWindowsAppxDeploymentType

Para obter mais informações, consulte Set-CMWindowsAppxDeploymentType.

Alterações não-quebrando

Função adicional para suporte MSIX.

Start-CMCloudManagementGateway

Para obter mais informações, consulte Start-CMCloudManagementGateway.

Insetos que foram corrigidos

Corrigiu a validação para o estado de CMG.

Start-CMContentDistribution

Para obter mais informações, consulte Start-CMContentDistribution.

Alterações não-quebrando

Adicionados pseudónimos para o parâmetro DeploymentPackageId e DeploymentPackageName para uma melhor compreensão.

Stop-CMCloudManagementGateway

Para mais informações, consulte Stop-CMCloudManagementGateway.

Insetos que foram corrigidos

Corrigiu a validação para o estado de CMG.

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.