Set-CMBaseline

Référence

Module:: ConfigurationManager

Modifiez les paramètres des bases de référence de configuration.

Syntaxe

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

Utilisez cette applet de commande pour modifier les paramètres d’une base de référence de configuration dans Configuration Manager. Une base de référence de configuration peut inclure les types de données de configuration suivants :

Éléments de configuration
Autres bases de référence de configuration
Mises à jour logicielles

Le client Configuration Manager évalue sa conformité par rapport à cette base de référence. Si tous les éléments spécifiés sont conformes, la ligne de base elle-même est évaluée comme conforme. Vous pouvez également inclure des éléments facultatifs, qui sont évalués uniquement si l’application ou le paramètre approprié existe sur l’appareil.

Pour plus d’informations, consultez Créer des bases de référence de configuration dans Configuration Manager.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Configurer une base de référence de configuration

Cet exemple utilise d’abord l’applet de commande Get-CMConfigurationItem pour obtenir une série d’éléments de configuration (CI).

Il place ensuite les paramètres de l’applet de commande dans la variable de paramètres . Il n’est pas nécessaire de plaquer les paramètres. Cela facilite simplement la lecture des paramètres pour une ligne de commande aussi longue.

La dernière commande configure la base de référence PSTestBaseLine avec un nouveau nom et une nouvelle description, supprime une catégorie et ajoute les instances de configuration.

$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

Exemple 2 : Ajouter une catégorie personnalisée

Cet exemple utilise d’abord l’applet de commande New-CMCategory pour créer une catégorie de base de référence personnalisée Accounting. Il configure ensuite la base de référence Comptabilité pour ajouter la nouvelle catégorie.

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

Paramètres

-AddBaseline

Spécifiez un tableau d’ID de base à ajouter en tant que données de configuration à la base de référence cible. Cette valeur est la propriété CI_ID de la base de référence, par exemple . 16777516

Type:	String[]
Alias:	AddBaselines
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AddCategory

Spécifiez un tableau de noms de catégorie de configuration à ajouter aux bases de référence de configuration. Ces catégories améliorent la recherche et le filtrage. Par défaut, le site inclut les catégories suivantes pour les bases de référence de configuration :

Client
Infrastructure informatique
Ligne de l’entreprise
Serveur

Pour utiliser une autre catégorie, commencez par l’ajouter avec l’applet de commande et -CategoryType BaselineCategories le paramètre New-CMCategory.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AddOptionalConfigurationItem

Spécifiez un tableau d’ID d’élément de configuration à ajouter avec un objectif facultatif . Le client Configuration Manager évalue uniquement les éléments facultatifs si l’application appropriée existe sur l’appareil.

Cette valeur est la propriété CI_ID de l’élément de configuration, par exemple . 16777514

Type:	String[]
Alias:	AddOptionalConfigurationItems
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AddOSConfigurationItem

Spécifiez un tableau d’ID d’élément de configuration à ajouter de type système d’exploitation. Cette valeur est la propriété CI_ID de l’élément de configuration, par exemple . 16777514

Type:	String[]
Alias:	AddOSConfigurationItems
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AddProhibitedConfigurationItem

Spécifiez un tableau d’ID d’élément de configuration à ajouter avec un objectif interdit . Cette valeur est la propriété CI_ID de l’élément de configuration, par exemple . 16777514

Type:	String[]
Alias:	AddProhibitedConfigurationItems
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AddRequiredConfigurationItem

Spécifiez un tableau d’ID d’élément de configuration à ajouter avec un objectif requis . Cette valeur est la propriété CI_ID de l’élément de configuration, par exemple . 16777514

Type:	String[]
Alias:	AddRequiredConfigurationItems
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AddSoftwareUpdate

Spécifiez un tableau d’ID de mise à jour logicielle à ajouter.

Type:	String[]
Alias:	AddSoftwareUpdates
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AllowComanagedClients

Définissez ce paramètre sur $true pour toujours appliquer cette base de référence, même pour les clients cogérés.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ClearBaseline

Ajoutez ce paramètre pour supprimer toutes les bases de référence en tant que conditions d’évaluation de la base de référence cible. Pour supprimer des bases de référence individuelles, utilisez le paramètre RemoveBaseline .

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ClearOptionalConfigurationItem

Ajoutez ce paramètre pour supprimer tous les éléments de configuration facultatifs en tant que conditions d’évaluation de la base de référence cible. Pour supprimer des instances de certification facultatives individuelles, utilisez le paramètre RemoveOptionalConfigurationItem .

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ClearOSConfigurationItem

Ajoutez ce paramètre pour supprimer tous les éléments de configuration du système d’exploitation en tant que conditions d’évaluation de la base de référence cible. Pour supprimer des instances de configuration de système d’exploitation individuelles, utilisez le paramètre RemoveOSConfigurationItem .

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ClearProhibitedConfigurationItem

Ajoutez ce paramètre pour supprimer tous les éléments de configuration interdits en tant que conditions d’évaluation de la base de référence cible. Pour supprimer des instances de certification interdites individuelles, utilisez le paramètre RemoveProhibitedConfigurationItem .

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ClearRequiredConfigurationItem

Ajoutez ce paramètre pour supprimer tous les éléments de configuration requis en tant que conditions d’évaluation de la base de référence cible. Pour supprimer les instances de certification requises individuelles, utilisez le paramètre RemoveRequiredConfigurationItem .

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ClearSoftwareUpdate

Ajoutez ce paramètre pour supprimer toutes les mises à jour logicielles en tant que conditions d’évaluation de la base de référence cible. Pour supprimer des mises à jour logicielles individuelles, utilisez le paramètre RemoveSoftwareUpdate .

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Description

Spécifiez une description facultative de la base de référence de configuration pour vous aider à l’identifier.

Type:	String
Alias:	LocalizedDescription
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DesiredConfigurationDigestPath

Spécifiez un chemin d’accès aux données de configuration stockées sous forme de synthèse XML.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Id

Spécifiez le CI_ID de la base de référence de configuration à configurer. Par exemple : 16777516.

Type:	Int32
Alias:	CIId, CI_ID
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

Spécifiez un objet de base de référence de configuration à configurer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMBaseline .

Type:	IResultObject
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Name

Spécifiez le nom de la base de référence de configuration à configurer.

Type:	String
Alias:	LocalizedDisplayName
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-NewName

Spécifiez un nouveau nom pour la base de référence de configuration. Utilisez ce paramètre pour renommer la base de référence cible.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RemoveBaseline

Spécifiez un tableau d’ID de ligne de base à supprimer en tant que données de configuration de la base de référence cible. Cette valeur est la propriété CI_ID de la base de référence, par exemple . 16777516 Pour supprimer toutes les bases de référence en tant que données de configuration de cette base de référence, utilisez le paramètre ClearBaseline .

Type:	String[]
Alias:	RemoveBaselines
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RemoveCategory

Spécifiez un tableau de noms de catégorie de configuration à supprimer de la base de référence de configuration.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RemoveOptionalConfigurationItem

Spécifiez un tableau d’ID CI facultatifs à supprimer en tant que données de configuration de la base de référence cible. Cette valeur est la propriété CI_ID de l’élément de configuration, par exemple . 16777514 Pour supprimer tous les éléments de configuration facultatifs de cette base de référence, utilisez le paramètre ClearOptionalConfigurationItem .

Type:	String[]
Alias:	RemoveOptionalConfigurationItems
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RemoveOSConfigurationItem

Spécifiez un tableau d’ID CI de système d’exploitation à supprimer en tant que données de configuration de la base de référence cible. Cette valeur est la propriété CI_ID de l’élément de configuration, par exemple . 16777514 Pour supprimer tous les éléments de configuration du système d’exploitation de cette base de référence, utilisez le paramètre ClearOSConfigurationItem .

Type:	String[]
Alias:	RemoveOSConfigurationItems
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RemoveProhibitedConfigurationItem

Spécifiez un tableau d’ID CI interdits à supprimer en tant que données de configuration de la base de référence cible. Cette valeur est la propriété CI_ID de l’élément de configuration, par exemple . 16777514 Pour supprimer tous les éléments de configuration interdits de cette base de référence, utilisez le paramètre ClearProhibitedConfigurationItem .

Type:	String[]
Alias:	RemoveProhibitedConfigurationItems
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RemoveRequiredConfigurationItem

Spécifiez un tableau d’ID CI requis à supprimer en tant que données de configuration de la base de référence cible. Cette valeur est la propriété CI_ID de l’élément de configuration, par exemple . 16777514 Pour supprimer tous les éléments de configuration requis de cette base de référence, utilisez le paramètre ClearRequiredConfigurationItem .

Type:	String[]
Alias:	RemoveRequiredConfigurationItems
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RemoveSoftwareUpdate

Spécifiez un tableau d’ID de mise à jour logicielle à supprimer en tant que données de configuration de la base de référence cible. Pour supprimer toutes les mises à jour logicielles de cette base de référence, utilisez le paramètre ClearSoftwareUpdate .

Type:	String[]
Alias:	RemoveSoftwareUpdates
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Commentaires

Cette page a-t-elle été utile ?