建立檔案的偵測方法子句。
\n","uid":"ConfigurationManager.New-CMDetectionClauseFile"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMDetectionClauseFile":{"href":"new-cmdetectionclausefile","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMDetectionClauseFile","schemaType":"PowershellCmdlet","summary":"建立檔案的偵測方法子句。
\n","uid":"ConfigurationManager.New-CMDetectionClauseFile"}},"description":"使用此 Cmdlet 在應用程式的偵測方法中建立 子句。 這個子句是指出應用程式存在的檔案規則。
\n若要偵測資料夾而非檔案，請使用 New-CMDetectionClauseDirectory Cmdlet 。
\n使用此 Cmdlet 之後，請針對部署類型使用其中一個 Add- 或 Set- Cmdlet。 將此偵測子句對象傳遞至 AddDetectionClause 或 RemoveDetectionClause 參數。
\n若要將偵測子句分組，請在部署類型 Cmdlet 上使用 GroupDetectionClauses 參數。
\n注意事項
\n從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\\>。 如需詳細資訊，請 參閱開始使用。
此範例會偵測版本大於或等於 1.0.0之特定檔夾中的應用程式 app.exe。
此範例會建立兩個檔案子句和一個登錄子句，然後使用它們將 MSI 部署類型新增至應用程式。
\n","title":"範例 2：建立 MSI 應用程式部署類型的多個子句"}],"inputs":[{"description":"","name":"None\n"}],"links":[{"href":"new-cmdetectionclausedirectory","text":"New-CMDetectionClauseDirectory"},{"href":"new-cmdetectionclauseregistrykey","text":"New-CMDetectionClauseRegistryKey"},{"href":"new-cmdetectionclauseregistrykeyvalue","text":"New-CMDetectionClauseRegistryKeyValue"},{"href":"new-cmdetectionclausewindowsinstaller","text":"New-CMDetectionClauseWindowsInstaller"}],"module":"ConfigurationManager","name":"New-CMDetectionClauseFile","notes":"","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"當您新增此參數時，檔案必須存在於目標系統上，以指出此應用程式是否存在。
\n若要評估此檔案屬性的規則，請使用 Value 參數，而不只是存在。
\n","isRequired":true,"name":"Existence","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"當您新增 Value 參數時，請使用 ExpectedValue 搭配 PropertyType 和 ExpressionOperator。 當您使用這些參數時，檔案必須滿足規則，以指出此應用程式是否存在。 這個 ExpectedValue 參數會指定要與文件系統比較的值。
\n要比較的值取決於指定的 PropertyType。
\n","isRequired":true,"name":"ExpectedValue","parameterValueGroup":"","position":"Named","type":"String[]
\n"},{"aliases":"","defaultValue":"None","description":"當您新增 Value 參數時，請搭配 PropertyType 和 ExpectedValue 使用 ExpressionOperator。 當您使用這些參數時，檔案必須滿足規則，以指出此應用程式是否存在。 這個 ExpressionOperator 參數會指定比較文件系統值與預期值的運算符。
\n從 2010 版開始，參數類型從 RuleExpressionOperator 變更為 FileFolderRuleExpressionOperator。
\n","isRequired":true,"name":"ExpressionOperator","parameterValueGroup":"IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf","position":"Named","type":"FileFolderRuleExpressionOperator\n"},{"aliases":"","defaultValue":"None","description":"指定指出應用程式存在的檔名。 使用 Path 參數來指定此檔案的路徑。
\n例如，Configuration Manager 控制台預設會安裝為 C:\\Program Files (x86)\\Microsoft Endpoint Manager\\AdminConsole\\bin\\Microsoft.ConfigurationManagement.exe。 若要建立此檔案的規則，請將此參數 Microsoft.ConfigurationManagement.exe 設定為 ，並將 Path 參數設定為 %ProgramFiles(x86)%\\Microsoft Endpoint Manager\\AdminConsole\\bin。
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"新增此參數，表示此檔案與64位系統上的32位應用程式相關聯。
\n","name":"Is64Bit","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"指定檔案系統中指出應用程式存在的檔案路徑。 使用 FileName 參數來指定檔名。
\n例如，Configuration Manager 控制台預設會安裝為 C:\\Program Files (x86)\\Microsoft Endpoint Manager\\AdminConsole\\bin\\Microsoft.ConfigurationManagement.exe。 若要建立此檔案的規則，請將此參數 %ProgramFiles(x86)%\\Microsoft Endpoint Manager\\AdminConsole\\bin 設定為 ，並將 FileName 參數設定為 Microsoft.ConfigurationManagement.exe。
當您新增 Value 參數時，請搭配 ExpressionOperator 和 ExpectedValue 使用 PropertyType。 當您使用這些參數時，檔案必須滿足規則，以指出此應用程式是否存在。 這個 PropertyType 參數會指定要評估的檔案屬性。
\n例如，您將此參數設定為 Version，將 ExpressionOperator 設定為 IsEquals，並將 ExpectedValue 設定 為 1.48.1.0。 規則接著會檢查指定的檔案是否具有相同的檔案版本。
當您新增 Value 參數時，檔案必須滿足規則，以指出此應用程式是否存在。 使用此參數搭配下列參數： ExpectedValue、 ExpressionOperator 和 PropertyType。
\n若只要檢查檔案是否存在，請使用 Existence 參數，而不是評估規則。
\n","isRequired":true,"name":"Value","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"建立檔案的偵測方法子句。
\n","syntaxes":["New-CMDetectionClauseFile -FileName建立檔案的偵測方法子句。
\n","uid":"ConfigurationManager.New-CMDetectionClauseFile"}],"canonical_url":"https://learn.microsoft.com/zh-tw/powershell/module/configurationmanager/new-cmdetectionclausefile?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/zh-tw/powershell/module/configurationmanager/new-cmdetectionclausefile?view=sccm-ps"},"pageMetadata":"使用此 Cmdlet 在應用程式的偵測方法中建立 子句。 這個子句是指出應用程式存在的檔案規則。\n若要偵測資料夾而非檔案，請使用 New-CMDetectionClauseDirectory Cmdlet 。
\n使用此 Cmdlet 之後，請針對部署類型使用其中一個 Add- 或 Set- Cmdlet。 將此偵測子句對象傳遞至 AddDetectionClause 或 RemoveDetectionClause 參數。
\n若要將偵測子句分組，請在部署類型 Cmdlet 上使用 GroupDetectionClauses 參數。
\n注意事項
\n從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\\>。 如需詳細資訊，請 參閱開始使用。