Lire en anglais

Partager via

New-CMRequirementRuleFileAttributeValue

  • Référence
Module:
ConfigurationManager

Créez une règle d’exigence pour vérifier les attributs de fichier.

Syntaxe

PowerShell 
New-CMRequirementRuleFileAttributeValue
   [-FileArchive <AttributeVerificationOption>]
   [-FileCompressed <AttributeVerificationOption>]
   [-FileEncrypted <AttributeVerificationOption>]
   [-FileHidden <AttributeVerificationOption>]
   [-FileReadOnly <AttributeVerificationOption>]
   [-FileSystem <AttributeVerificationOption>]
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer une règle d’exigence sur un type de déploiement d’application qui vérifie les attributs de fichier. Par exemple, Masqué ou Lecture seule. Elle nécessite une condition globale personnalisée de type de données File.

Conseil

À des fins de comparaison, si vous créez manuellement cette règle de configuration requise dans la console Configuration Manager, sélectionnez les options suivantes :

  • Catégorie : Personnalisé
  • Condition : sélectionnez une condition globale personnalisée de type de données Fichier
  • Type de règle : Valeur
  • Propriété : Attributs

Après avoir utilisé cette applet de commande, utilisez l’une des applets de commande Add- ou Set- pour les types de déploiement. Transmettez cet objet de règle d’exigence aux paramètres AddRequirement ou RemoveRequirement .

Pour plus d’informations, consultez Configuration requise du type de déploiement et Créer des conditions globales.

Notes

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

Cet exemple utilise d’abord l’applet de commande Get-CMGlobalCondition pour obtenir une condition globale personnalisée. Ensuite, il crée l’objet de règle d’exigence pour vérifier que les bits archive, masqué et système sont activés dans le fichier. Enfin, il transmet cet objet de règle à l’applet de commande Set-CMScriptDeploymentType pour ajouter la condition requise.

PowerShell 
$myGC = Get-CMGlobalCondition -Name "pagefile.sys"
$myRule = New-CMRequirementRuleFileAttributeValue -GlobalCondition $myGC -FileArchive On -FileHidden On -FileSystem On

Set-CMScriptDeploymentType -ApplicationName "Central app" -DeploymentTypeName "Install" -AddRequirement $myRule

Paramètres

-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

-FileArchive

Définissez ce paramètre sur On pour vérifier le bit Archive sur le fichier. Par défaut, la condition ne vérifie pas l’attribut.

Type:AttributeVerificationOption
Valeurs acceptées:On, Off, DoNotVerify
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FileCompressed

Définissez ce paramètre sur On pour vérifier le bit compressé sur le fichier. Par défaut, la condition ne vérifie pas l’attribut.

Type:AttributeVerificationOption
Valeurs acceptées:On, Off, DoNotVerify
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FileEncrypted

Définissez ce paramètre sur On pour vérifier le bit chiffré sur le fichier. Par défaut, la condition ne vérifie pas l’attribut.

Type:AttributeVerificationOption
Valeurs acceptées:On, Off, DoNotVerify
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FileHidden

Définissez ce paramètre sur On pour vérifier le bit masqué sur le fichier. Par défaut, la condition ne vérifie pas l’attribut.

Type:AttributeVerificationOption
Valeurs acceptées:On, Off, DoNotVerify
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FileReadOnly

Définissez ce paramètre sur On pour vérifier le bit En lecture seule sur le fichier. Par défaut, la condition ne vérifie pas l’attribut.

Type:AttributeVerificationOption
Valeurs acceptées:On, Off, DoNotVerify
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FileSystem

Définissez ce paramètre sur On pour vérifier le bit système sur le fichier. Par défaut, la condition ne vérifie pas l’attribut.

Type:AttributeVerificationOption
Valeurs acceptées:On, Off, DoNotVerify
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

-InputObject

Spécifiez un objet de condition globale personnalisé à utiliser comme base pour cette règle d’exigence. Pour obtenir cet objet, utilisez l’applet de commande Get-CMGlobalCondition .

Pour afficher la liste des conditions globales de fichier disponibles sur le site, utilisez la commande PowerShell suivante :

Get-CMGlobalCondition | Where-Object DataType -eq "File" | Select-Object LocalizedDisplayName

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object