Set-CMBaseline
Altere as configurações das linhas de base de configuração.
Syntax
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
Use esse cmdlet para alterar as configurações de uma linha de base de configuração em 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 Configuration Manager avalia sua conformidade com essa linha de base. Se todos os itens especificados estiverem em conformidade, a linha de base em si será avaliada como compatível. Você também pode incluir itens opcionais, que só são avaliados se o aplicativo ou a configuração relevante existir no dispositivo.
Para obter mais informações, consulte Criar linhas de base de configuração no Configuration Manager.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: configurar uma linha de base de configuração
Este exemplo usa primeiro o cmdlet Get-CMConfigurationItem para obter uma série de CIs (itens de configuração).
Em seguida, ele coloca os parâmetros de cmdlet na variável de parâmetros . Não é necessário emendar os parâmetros, apenas facilita a leitura dos parâmetros para uma linha de comando tão longa.
O último comando configura a linha de base PSTestBaseLine com um novo nome e descrição, remove uma categoria e adiciona os 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 @parametersExemplo 2: Adicionar uma categoria personalizada
Este exemplo usa primeiro o cmdlet New-CMCategory para criar uma categoria de linha de base personalizada Contabilidade. Em seguida, ele configura a linha de base contábil para adicionar a nova categoria.
$category = New-CMCategory -CategoryType BaselineCategories -Name "Accounting"
Set-CMBaseline -Name "Accounting baseline" -AddCategory $category.LocalizedCategoryInstanceNameParâmetros
-AddBaseline
Especifique uma matriz de IDs de linha de base para adicionar dados de configuração à linha de base de destino. Esse valor é a propriedade CI_ID da linha de base, por exemplo, 16777516.
| Type: | String[] |
| Aliases: | AddBaselines |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddCategory
Especifique uma matriz de nomes de categoria de configuração para adicionar às linhas de base de configuração. Essas categorias melhoram a pesquisa e a filtragem. Por padrão, o site inclui as seguintes categorias para linhas de base de configuração:
- Client
- Infraestrutura de TI
- Linha de Negócios
- Servidor
Para usar outra categoria, primeiro adicione-a com o cmdlet e -CategoryType BaselineCategories o parâmetro New-CMCategory.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddOptionalConfigurationItem
Especifique uma matriz de IDs de item de configuração para adicionar com uma finalidade opcional . O cliente Configuration Manager só avalia itens opcionais se o aplicativo relevante existir no dispositivo.
Esse valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514.
| Type: | String[] |
| Aliases: | AddOptionalConfigurationItems |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddOSConfigurationItem
Especifique uma matriz de IDs de item de configuração para adicionar o sistema operacional do tipo. Esse valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514.
| Type: | String[] |
| Aliases: | AddOSConfigurationItems |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddProhibitedConfigurationItem
Especifique uma matriz de IDs de item de configuração para adicionar com uma finalidade proibida . Esse valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514.
| Type: | String[] |
| Aliases: | AddProhibitedConfigurationItems |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddRequiredConfigurationItem
Especifique uma matriz de IDs de item de configuração para adicionar com uma finalidade necessária . Esse valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514.
| Type: | String[] |
| Aliases: | AddRequiredConfigurationItems |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddSoftwareUpdate
Especifique uma matriz de IDs de atualização de software a serem adicionadas.
| Type: | String[] |
| Aliases: | AddSoftwareUpdates |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowComanagedClients
Defina esse parâmetro para $true sempre aplicar essa linha de base mesmo para clientes cogerenciados.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearBaseline
Adicione esse 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, use o parâmetro RemoveBaseline .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearOptionalConfigurationItem
Adicione esse 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 CIs opcionais individuais, use o parâmetro RemoveOptionalConfigurationItem .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearOSConfigurationItem
Adicione esse parâmetro para remover todos os itens de configuração do sistema operacional como condições de avaliação da linha de base de destino. Para remover CIs individuais do sistema operacional, use o parâmetro RemoveOSConfigurationItem .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearProhibitedConfigurationItem
Adicione esse 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 CIs proibidos individuais, use o parâmetro RemoveProhibitedConfigurationItem .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearRequiredConfigurationItem
Adicione esse 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 CIs necessários individuais, use o parâmetro RemoveRequiredConfigurationItem .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearSoftwareUpdate
Adicione esse 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, use o parâmetro RemoveSoftwareUpdate .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Especifique uma descrição opcional da linha de base de configuração para ajudar a identificá-la.
| Type: | String |
| Aliases: | LocalizedDescription |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DesiredConfigurationDigestPath
Especifique um caminho para os dados de configuração armazenados como um resumo XML.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Especifique o CI_ID da linha de base de configuração a ser configurada. Por exemplo, 16777516.
| Type: | Int32 |
| Aliases: | CIId, CI_ID |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Especifique um objeto de linha de base de configuração a ser configurado. Para obter esse objeto, use o cmdlet Get-CMBaseline .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifique o nome da linha de base de configuração a ser configurada.
| Type: | String |
| Aliases: | LocalizedDisplayName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Especifique um novo nome para a linha de base de configuração. Use esse parâmetro para renomear a linha de base de destino.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveBaseline
Especifique uma matriz de IDs de linha de base para remover como dados de configuração da linha de base de destino. Esse valor é a propriedade CI_ID da linha de base, por exemplo, 16777516. Para remover todas as linhas de base como dados de configuração dessa linha de base, use o parâmetro ClearBaseline .
| Type: | String[] |
| Aliases: | RemoveBaselines |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveCategory
Especifique uma matriz de nomes de categoria de configuração para remover da linha de base de configuração.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveOptionalConfigurationItem
Especifique uma matriz de IDs de CI opcionais para remover como dados de configuração da linha de base de destino. Esse valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514. Para remover todos os itens de configuração opcionais dessa linha de base, use o parâmetro ClearOptionalConfigurationItem .
| Type: | String[] |
| Aliases: | RemoveOptionalConfigurationItems |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveOSConfigurationItem
Especifique uma matriz de IDs de CI do sistema operacional para remover como dados de configuração da linha de base de destino. Esse valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514. Para remover todos os itens de configuração do sistema operacional desta linha de base, use o parâmetro ClearOSConfigurationItem .
| Type: | String[] |
| Aliases: | RemoveOSConfigurationItems |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveProhibitedConfigurationItem
Especifique uma matriz de IDs de CI proibidas para remover como dados de configuração da linha de base de destino. Esse valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514. Para remover todos os itens de configuração proibidos dessa linha de base, use o parâmetro ClearProhibitedConfigurationItem .
| Type: | String[] |
| Aliases: | RemoveProhibitedConfigurationItems |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveRequiredConfigurationItem
Especifique uma matriz de IDs de CI necessárias para remover como dados de configuração da linha de base de destino. Esse valor é a propriedade CI_ID do item de configuração, por exemplo, 16777514. Para remover todos os itens de configuração necessários dessa linha de base, use o parâmetro ClearRequiredConfigurationItem .
| Type: | String[] |
| Aliases: | RemoveRequiredConfigurationItems |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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, use o parâmetro ClearSoftwareUpdate .
| Type: | String[] |
| Aliases: | RemoveSoftwareUpdates |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object
Links Relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de