New-CMRequirementRuleFileAttributeValue

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie eine Anforderungsregel, um Dateiattribute zu überprüfen.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Anforderungsregel für einen Anwendungsbereitstellungstyp zu erstellen, der Dateiattribute überprüft. Beispiel: Ausgeblendet oder Schreibgeschützt. Hierfür ist eine benutzerdefinierte globale Bedingung des Datentyps File erforderlich.

Tipp

Wenn Sie diese Anforderungsregel manuell in der Configuration Manager-Konsole erstellen, wählen Sie zum Vergleich die folgenden Optionen aus:

  • Kategorie: Benutzerdefiniert
  • Bedingung: Wählen Sie eine benutzerdefinierte globale Bedingung des Datentyps Datei aus.
  • Regeltyp: Wert
  • Eigenschaft: Attribute

Nachdem Sie dieses Cmdlet verwendet haben, verwenden Sie eines der Add- oder Set-Cmdlets für Bereitstellungstypen. Übergeben Sie dieses Anforderungsregelobjekt entweder an die Parameter AddRequirement oder RemoveRequirement .

Weitere Informationen finden Sie unter Anforderungen für Den Bereitstellungstyp und Erstellen globaler Bedingungen.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1

In diesem Beispiel wird zunächst das Cmdlet Get-CMGlobalCondition verwendet, um eine benutzerdefinierte globale Bedingung abzurufen. Als Nächstes wird das Anforderungsregelobjekt erstellt, um zu überprüfen, ob die Datei das Archiv enthält, ausgeblendet und Systembits aktiviert sind. Schließlich wird dieses Regelobjekt an das Cmdlet Set-CMScriptDeploymentType übergeben, um die Anforderung hinzuzufügen.

$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

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-FileArchive

Legen Sie diesen Parameter auf fest On , um das Archivbit für die Datei zu überprüfen. Standardmäßig überprüft die Bedingung das Attribut nicht.

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

-FileCompressed

Legen Sie diesen Parameter auf fest On , um das komprimierte Bit für die Datei zu überprüfen. Standardmäßig überprüft die Bedingung das Attribut nicht.

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

-FileEncrypted

Legen Sie diesen Parameter auf fest On , um das verschlüsselte Bit für die Datei zu überprüfen. Standardmäßig überprüft die Bedingung das Attribut nicht.

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

-FileHidden

Legen Sie diesen Parameter auf fest On , um das ausgeblendete Bit in der Datei zu überprüfen. Standardmäßig überprüft die Bedingung das Attribut nicht.

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

-FileReadOnly

Legen Sie diesen Parameter auf fest On , um das Schreibgeschützte Bit für die Datei zu überprüfen. Standardmäßig überprüft die Bedingung das Attribut nicht.

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

-FileSystem

Legen Sie diesen Parameter auf fest On , um das Systembit für die Datei zu überprüfen. Standardmäßig überprüft die Bedingung das Attribut nicht.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-InputObject

Geben Sie ein benutzerdefiniertes globales Bedingungsobjekt an, das als Grundlage für diese Anforderungsregel verwendet werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMGlobalCondition .

Verwenden Sie den folgenden PowerShell-Befehl, um die Liste der verfügbaren globalen Dateibedingungen auf der Website anzuzeigen:

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object