New-CMRequirementRuleFileAttributeValue

  • Riferimento
Modulo:
ConfigurationManager

Creare una regola di requisito per verificare gli attributi del file.

Sintassi

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

Descrizione

Usare questo cmdlet per creare una regola di requisito in un tipo di distribuzione dell'applicazione che verifica gli attributi del file. Ad esempio, Nascosto o Sola lettura. Richiede una condizione globale personalizzata del tipo di dati File.

Consiglio

Per il confronto, se si crea manualmente questa regola dei requisiti nella console di Configuration Manager, selezionare le opzioni seguenti:

  • Categoria: Personalizzata
  • Condizione: selezionare una condizione globale personalizzata del tipo di dati File
  • Tipo di regola: Valore
  • Proprietà: Attributi

Dopo aver usato questo cmdlet, usare uno dei cmdlet Add- o Set- per i tipi di distribuzione. Passare questo oggetto regola di requisito ai parametri AddRequirement o RemoveRequirement .

Per altre informazioni, vedere Requisiti del tipo di distribuzione e Creare condizioni globali.

Nota

Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1

Questo esempio usa innanzitutto il cmdlet Get-CMGlobalCondition per ottenere una condizione globale personalizzata. Successivamente viene creato l'oggetto regola dei requisiti per verificare che il file abbia i bit di archivio, nascosti e di sistema attivati. Infine passa l'oggetto regola al cmdlet Set-CMScriptDeploymentType per aggiungere il requisito.

$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

Parametri

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileArchive

Impostare questo parametro su On per verificare il bit Archive nel file. Per impostazione predefinita, la condizione non verifica l'attributo.

Type:AttributeVerificationOption
Accepted values:On, Off, DoNotVerify
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileCompressed

Impostare questo parametro su On per verificare il bit compresso nel file. Per impostazione predefinita, la condizione non verifica l'attributo.

Type:AttributeVerificationOption
Accepted values:On, Off, DoNotVerify
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileEncrypted

Impostare questo parametro su On per verificare il bit Encrypted nel file. Per impostazione predefinita, la condizione non verifica l'attributo.

Type:AttributeVerificationOption
Accepted values:On, Off, DoNotVerify
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileHidden

Impostare questo parametro su On per verificare il bit Nascosto nel file. Per impostazione predefinita, la condizione non verifica l'attributo.

Type:AttributeVerificationOption
Accepted values:On, Off, DoNotVerify
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileReadOnly

Impostare questo parametro su On per verificare il bit di sola lettura nel file. Per impostazione predefinita, la condizione non verifica l'attributo.

Type:AttributeVerificationOption
Accepted values:On, Off, DoNotVerify
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileSystem

Impostare questo parametro su On per verificare il bit di sistema nel file. Per impostazione predefinita, la condizione non verifica l'attributo.

Type:AttributeVerificationOption
Accepted values:On, Off, DoNotVerify
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specificare un oggetto condizione globale personalizzato da usare come base per questa regola del requisito. Per ottenere questo oggetto, usare il cmdlet Get-CMGlobalCondition .

Per visualizzare l'elenco delle condizioni globali dei file disponibili nel sito, usare il comando di PowerShell seguente:

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

Type:IResultObject
Aliases:GlobalCondition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object