Compartilhar via

New-CMRequirementRuleFileAttributeValue

  • Referência
Módulo:
ConfigurationManager

Crie uma regra de requisito para verificar atributos de arquivo.

Sintaxe

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

Description

Use esse cmdlet para criar uma regra de requisito em um tipo de implantação de aplicativo que verifica atributos de arquivo. Por exemplo, somente Oculta ou Leitura. Ele requer uma condição global personalizada do tipo de dados Arquivo.

Dica

Para comparação, se você criar manualmente essa regra de requisito no console Configuration Manager, selecione as seguintes opções:

  • Categoria: Personalizado
  • Condição: selecione uma condição global personalizada do arquivo do tipo de dados
  • Tipo de regra: Valor
  • Propriedade: Atributos

Depois de usar esse cmdlet, use um dos cmdlets Adicionar ou Definir para tipos de implantação. Passe esse objeto de regra de requisito para os parâmetros AddRequirement ou RemoveRequirement .

Para obter mais informações, consulte Requisitos de tipo de implantação e Criar condições globais.

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

Este exemplo usa primeiro o cmdlet Get-CMGlobalCondition para obter uma condição global personalizada. Em seguida, ele cria o objeto de regra de requisito para verificar se o arquivo tem os bits de arquivo, ocultos e do sistema ativados. Por fim, ele passa esse objeto de regra para o cmdlet Set-CMScriptDeploymentType para adicionar o 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

Parâmetros

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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

-FileArchive

Defina esse parâmetro para On verificar o bit Arquivo no arquivo. Por padrão, a condição não verifica o atributo.

Tipo:AttributeVerificationOption
Valores aceitos:On, Off, DoNotVerify
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FileCompressed

Defina esse parâmetro para On verificar o bit compactado no arquivo. Por padrão, a condição não verifica o atributo.

Tipo:AttributeVerificationOption
Valores aceitos:On, Off, DoNotVerify
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FileEncrypted

Defina esse parâmetro para On verificar o bit Criptografado no arquivo. Por padrão, a condição não verifica o atributo.

Tipo:AttributeVerificationOption
Valores aceitos:On, Off, DoNotVerify
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FileHidden

Defina esse parâmetro para On verificar o bit Oculto no arquivo. Por padrão, a condição não verifica o atributo.

Tipo:AttributeVerificationOption
Valores aceitos:On, Off, DoNotVerify
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FileReadOnly

Defina esse parâmetro para On verificar o bit Somente leitura no arquivo. Por padrão, a condição não verifica o atributo.

Tipo:AttributeVerificationOption
Valores aceitos:On, Off, DoNotVerify
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FileSystem

Defina esse parâmetro para On verificar o bit do Sistema no arquivo. Por padrão, a condição não verifica o atributo.

Tipo:AttributeVerificationOption
Valores aceitos:On, Off, DoNotVerify
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

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

-InputObject

Especifique um objeto de condição global personalizado a ser usado como base para essa regra de requisito. Para obter esse objeto, use o cmdlet Get-CMGlobalCondition .

Para ver a lista de condições globais de arquivo disponíveis no site, use o seguinte comando do PowerShell:

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

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object