Condividi tramite

New-CMRequirementRuleFilePermissionValue

  • Riferimento
Modulo:
ConfigurationManager

Creare una regola di requisito per verificare le autorizzazioni per i file.

Sintassi

New-CMRequirementRuleFilePermissionValue
   -ControlEntry <FileSystemAccessControlEntry[]>
   [-Exclusive <Boolean>]
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per creare una regola di requisito in un tipo di distribuzione dell'applicazione che verifica le autorizzazioni per i file. 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à: Autorizzazioni

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 i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Aggiungere una regola di requisito per le autorizzazioni per i file

Questo esempio usa innanzitutto il cmdlet Get-CMGlobalCondition per ottenere una condizione globale personalizzata. Viene quindi usato il cmdlet New-CMFileSystemAccessControlEntry per creare due voci di controllo di accesso per utenti specifici. Successivamente viene creato l'oggetto regola di requisito per verificare che il file disponga delle autorizzazioni specificate nelle voci di controllo di accesso. Infine passa l'oggetto regola al cmdlet Set-CMScriptDeploymentType per aggiungere il requisito.

$myGC = Get-CMGlobalCondition -Name "LOB app data file"

$userName = "contoso\jqpublic"
$ce = New-CMFileSystemAccessControlEntry -GroupOrUserName $userName -AccessOption Allow -Permission Read,Write

$userName2 = "contoso\jdoe"
$ce2 = New-CMFileSystemAccessControlEntry -GroupOrUserName $userName2 -AccessOption Allow -Permission Read

$myRule = New-CMRequirementRuleFilePermissionValue -GlobalCondition $myGC -ControlEntry $ce,$ce2

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

Parametri

-ControlEntry

Specificare una matrice di oggetti voce di controllo di accesso. Una voce di controllo di accesso definisce autorizzazioni specifiche per un utente o un gruppo specifico. Per ottenere questo oggetto, usare il cmdlet New-CMFileSystemAccessControlEntry .

Tipo:FileSystemAccessControlEntry[]
Alias:ControlEntries, FileSystemAccessControlEntry, FileSystemAccessControlEntries
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Exclusive

Se questo parametro è $true, affinché la regola sia conforme, deve corrispondere esattamente all'ACE specificato. Qualsiasi altra autorizzazione nel file causa l'esito negativo della regola.

Se impostato su $false, affinché la regola sia conforme, l'ACE specificato deve esistere e possono esistere anche altre autorizzazioni.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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

Tipo:IResultObject
Alias:GlobalCondition
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object