New-CMRequirementRuleFileAttributeValue

  • Referência
Módulo:
ConfigurationManager

Crie uma regra de requisito para verificar os atributos de ficheiro.

Sintaxe

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

Description

Utilize este cmdlet para criar uma regra de requisito num tipo de implementação de aplicação que verifique os atributos de ficheiro. Por exemplo, Oculto ou Só de Leitura. Requer uma condição global personalizada do tipo de dados Ficheiro.

Dica

Para comparação, se criar manualmente esta regra de requisitos na consola do Configuration Manager, selecione as seguintes opções:

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

Depois de utilizar este cmdlet, utilize um dos cmdlets Add- ou Set- para tipos de implementação. Transmita este objeto de regra de requisito para os parâmetros AddRequirement ou RemoveRequirement .

Para obter mais informações, veja Requisitos do tipo de implementação e Criar condições globais.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1

Este exemplo utiliza primeiro o cmdlet Get-CMGlobalCondition para obter uma condição global personalizada. Em seguida, cria o objeto de regra de requisito para verificar se o ficheiro tem o arquivo, oculto e os bits do sistema ativados. Por fim, transmite 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

Este parâmetro trata os carateres universais como valores de carateres literais. 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 este parâmetro como On para verificar o bit Arquivo no ficheiro. Por predefiniçã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 este parâmetro como On para verificar o Bit comprimido no ficheiro. Por predefiniçã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 este parâmetro como On para verificar o bit Encriptado no ficheiro. Por predefiniçã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 este parâmetro como On para verificar o bit Oculto no ficheiro. Por predefiniçã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 este parâmetro como On para verificar o bit Só de leitura no ficheiro. Por predefiniçã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 este parâmetro como On para verificar o Bit do sistema no ficheiro. Por predefiniçã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

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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 utilizar como base para esta regra de requisito. Para obter este objeto, utilize o cmdlet Get-CMGlobalCondition .

Para ver a lista de condições globais de Ficheiros disponíveis no site, utilize 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