Set-CMBaseline

Referência

Módulo:: ConfigurationManager

Altere as definições das linhas de base de configuração.

Sintaxe

Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -Id <Int32>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilize este cmdlet para alterar as definições de uma linha de base de configuração no Configuration Manager. Uma linha de base de configuração pode incluir os seguintes tipos de dados de configuração:

Itens de configuração
Outras linhas de base de configuração
Atualizações de software

O cliente do Configuration Manager avalia a conformidade com esta linha de base. Se todos os itens especificados estiverem em conformidade, a linha de base em si será avaliada como conforme. Também pode incluir itens opcionais, que só são avaliados se a aplicação ou definição relevante existir no dispositivo.

Para obter mais informações, veja Criar linhas de base de configuração no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Configurar uma linha de base de configuração

Este exemplo utiliza primeiro o cmdlet Get-CMConfigurationItem para obter uma série de itens de configuração (CIs).

Em seguida, introduz os parâmetros do cmdlet na variável parameters . Não é necessário alterar os parâmetros, apenas facilita a leitura dos parâmetros para uma linha de comandos tão longa.

O último comando configura a linha de base PSTestBaseLine com um novo nome e descrição, remove uma categoria e adiciona as CIs.

$objPSTestWinAppCI = Get-CMConfigurationItem -Name PSTestWinAppCI
$objPSTestWinAppCI2 = Get-CMConfigurationItem -Name PSTestWinAppCI2
$objPSTestWinOSCI = Get-CMConfigurationItem -Name PSTestWinOSCI
$objPSTestWinAppCI3 = Get-CMConfigurationItem -Name PSTestWinAppCI3
$objPSTestWinAppCI4 = Get-CMConfigurationItem -Name PSTestWinAppCI4
$objPSTestMDCI = Get-CMConfigurationItem -Name PSTestMDCI
$objPSTestMacCI = Get-CMConfigurationItem -Name PSTestMacCI

$parameters = @{
  Name = "PSTestBaseLine"
  NewName = "PSTestBaseLineNew"
  Description = "DCM Testing New"
  RemoveCategory = ("IT Infrastructure")
  AddRequiredConfigurationItems = ($objPSTestWinAppCI4.CI_ID,$objPSTestMDCI.CI_ID)
  AddProhibitedConfigurationItems = ($objPSTestWinAppCI.CI_ID)
  AddOSConfigurationItems = ($objPSTestWinOSCI.CI_ID,$objPSTestMacCI.CI_ID)
  AddOptionalConfigurationItems = ($objPSTestWinAppCI2.CI_ID,$objPSTestWinAppCI3.CI_ID)
}

Set-CMBaseline @parameters

Exemplo 2: Adicionar uma categoria personalizada

Este exemplo utiliza primeiro o cmdlet New-CMCategory para criar uma categoria de linha de base personalizada Contabilidade. Em seguida, configura a linha de base Contabilidade para adicionar a nova categoria.

$category = New-CMCategory -CategoryType BaselineCategories -Name "Accounting"
Set-CMBaseline -Name "Accounting baseline" -AddCategory $category.LocalizedCategoryInstanceName

Parâmetros

-AddBaseline

Especifique uma matriz de IDs de linha de base a adicionar como dados de configuração à linha de base de destino. Este valor é a propriedade CI_ID da linha de base, por exemplo, 16777516.

Tipo:	String[]
Aliases:	AddBaselines
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-AddCategory

Especifique uma matriz de nomes de categorias de configuração para adicionar às linhas de base de configuração. Estas categorias melhoram a pesquisa e a filtragem. Por predefinição, o site inclui as seguintes categorias para linhas de base de configuração:

Cliente
Infraestrutura de TI
Linha de Negócios
Servidor

Para utilizar outra categoria, adicione-a primeiro com o cmdlet -CategoryType BaselineCategories e o parâmetro New-CMCategory.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-AddOptionalConfigurationItem

Especifique uma matriz de IDs de itens de configuração a adicionar com um objetivo opcional . O cliente do Configuration Manager só avalia os itens opcionais se a aplicação relevante existir no dispositivo.

Este valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514.

Tipo:	String[]
Aliases:	AddOptionalConfigurationItems
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-AddOSConfigurationItem

Especifique uma matriz de IDs de item de configuração para adicionar o tipo SO. Este valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514.

Tipo:	String[]
Aliases:	AddOSConfigurationItems
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-AddProhibitedConfigurationItem

Especifique uma matriz de IDs de item de configuração a adicionar com um objetivo proibido . Este valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514.

Tipo:	String[]
Aliases:	AddProhibitedConfigurationItems
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-AddRequiredConfigurationItem

Especifique uma matriz de IDs de itens de configuração a adicionar com um objetivo obrigatório . Este valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514.

Tipo:	String[]
Aliases:	AddRequiredConfigurationItems
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-AddSoftwareUpdate

Especifique uma matriz de IDs de atualização de software a adicionar.

Tipo:	String[]
Aliases:	AddSoftwareUpdates
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-AllowComanagedClients

Defina este parâmetro como para $true aplicar sempre esta linha de base, mesmo para clientes cogeridos.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ClearBaseline

Adicione este parâmetro para remover todas as linhas de base como condições de avaliação da linha de base de destino. Para remover linhas de base individuais, utilize o parâmetro RemoveBaseline .

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ClearOptionalConfigurationItem

Adicione este parâmetro para remover todos os itens de configuração opcionais como condições de avaliação da linha de base de destino. Para remover as CIs opcionais individuais, utilize o parâmetro RemoveOptionalConfigurationItem .

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ClearOSConfigurationItem

Adicione este parâmetro para remover todos os itens de configuração do SO como condições de avaliação da linha de base de destino. Para remover as CIs individuais do SO, utilize o parâmetro RemoveOSConfigurationItem .

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ClearProhibitedConfigurationItem

Adicione este parâmetro para remover todos os itens de configuração proibidos como condições de avaliação da linha de base de destino. Para remover as CIs proibidas individuais, utilize o parâmetro RemoveProhibitedConfigurationItem .

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ClearRequiredConfigurationItem

Adicione este parâmetro para remover todos os itens de configuração necessários como condições de avaliação da linha de base de destino. Para remover as CIs necessárias individuais, utilize o parâmetro RemoveRequiredConfigurationItem .

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ClearSoftwareUpdate

Adicione este parâmetro para remover todas as atualizações de software como condições de avaliação da linha de base de destino. Para remover atualizações de software individuais, utilize o parâmetro RemoveSoftwareUpdate .

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Description

Especifique uma descrição opcional da linha de base de configuração para ajudar a identificá-la.

Tipo:	String
Aliases:	LocalizedDescription
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DesiredConfigurationDigestPath

Especifique um caminho para os dados de configuração armazenados como um resumo XML.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Id

Especifique o CI_ID da linha de base de configuração a configurar. Por exemplo, 16777516.

Tipo:	Int32
Aliases:	CIId, CI_ID
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

Especifique um objeto de linha de base de configuração a configurar. Para obter este objeto, utilize o cmdlet Get-CMBaseline .

Tipo:	IResultObject
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Name

Especifique o nome da linha de base de configuração a configurar.

Tipo:	String
Aliases:	LocalizedDisplayName
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-NewName

Especifique um novo nome para a linha de base de configuração. Utilize este parâmetro para mudar o nome da linha de base de destino.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RemoveBaseline

Especifique uma matriz de IDs de linha de base a remover como dados de configuração da linha de base de destino. Este valor é a propriedade CI_ID da linha de base, por exemplo, 16777516. Para remover todas as linhas de base como dados de configuração desta linha de base, utilize o parâmetro ClearBaseline .

Tipo:	String[]
Aliases:	RemoveBaselines
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RemoveCategory

Especifique uma matriz de nomes de categorias de configuração a remover da linha de base de configuração.

Tipo:	String[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RemoveOptionalConfigurationItem

Especifique uma matriz de IDs de CI opcionais a remover como dados de configuração da linha de base de destino. Este valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514. Para remover todos os itens de configuração opcionais desta linha de base, utilize o parâmetro ClearOptionalConfigurationItem .

Tipo:	String[]
Aliases:	RemoveOptionalConfigurationItems
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RemoveOSConfigurationItem

Especifique uma matriz de IDs de CI do SO para remover como dados de configuração da linha de base de destino. Este valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514. Para remover todos os itens de configuração do SO desta linha de base, utilize o parâmetro ClearOSConfigurationItem .

Tipo:	String[]
Aliases:	RemoveOSConfigurationItems
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RemoveProhibitedConfigurationItem

Especifique uma matriz de IDs de CI proibidos a remover como dados de configuração da linha de base de destino. Este valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514. Para remover todos os itens de configuração proibidos desta linha de base, utilize o parâmetro ClearProhibitedConfigurationItem .

Tipo:	String[]
Aliases:	RemoveProhibitedConfigurationItems
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RemoveRequiredConfigurationItem

Especifique uma matriz de IDs de CI necessários para remover como dados de configuração da linha de base de destino. Este valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514. Para remover todos os itens de configuração necessários desta linha de base, utilize o parâmetro ClearRequiredConfigurationItem .

Tipo:	String[]
Aliases:	RemoveRequiredConfigurationItems
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RemoveSoftwareUpdate

Especifique uma matriz de IDs de atualização de software para remover como dados de configuração da linha de base de destino. Para remover todas as atualizações de software desta linha de base, utilize o parâmetro ClearSoftwareUpdate .

Tipo:	String[]
Aliases:	RemoveSoftwareUpdates
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Compartilhar via