SignFile-Aufgabe

Signiert die angegebene Datei mit dem angegebenen Zertifikat.

Parameter

In der folgenden Tabelle werden die Parameter der SignFile-Aufgabe beschrieben.

Parameter	Beschreibung
CertificateThumbprint	Erforderlicher String-Parameter. Gibt das Zertifikat an, das für Signierung verwendet werden soll.Dieses Zertifikat muss sich im persönlichen Speicher des aktuellen Benutzers befinden.
SigningTarget	Erforderlicher ITaskItem-Parameter. Gibt die Dateien an, die mit dem Zertifikat signiert werden sollen.
TimestampUrl	Optionaler String-Parameter. Gibt die URL eines Timestampservers an.

Hinweise

Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der Task-Klasse.Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter Aufgabenbasisklasse.

Beispiel

Das folgende Beispiel verwendet die SignFile-Aufgabe zum Signieren der Dateien, die in der FilesToSign-Elementauflistung angegeben sind, mit dem in der Certificate-Eigenschaft angegebenen Zertifikat.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <FileToSign Include="File.exe" />
    </ItemGroup>

    <PropertyGroup>
        <Certificate>Cert.cer</Certificate>
    </PropertyGroup>

    <Target Name="Sign">
        <SignFile
            CertificateThumbprint="$(CertificateThumbprint)"
            SigningTarget="@(FileToSign)" />
    </Target>

</Project>

Hinweis
Der Zertifikatfingerabdruck ist der SHA1-Hash des Zertifikats.Weitere Informationen finden Sie unter Beziehen des SHA-1-Hashs eines vertrauenswürdigen Stamm-Zertifizierungsstellenzertifikats.

Das folgende Beispiel verwendet die Exec-Aufgabe zum Signieren der Dateien, die in der FilesToSign-Elementauflistung angegeben sind, mit dem in der Certificate-Eigenschaft angegebenen Zertifikat.Damit können während des Buildprozesses Windows Installer-Dateien signiert werden.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <FileToSign Include="File.msi" />
    </ItemGroup>

    <PropertyGroup>
        <Certificate>Cert.cer</Certificate>
    </PropertyGroup>

    <Target Name="Sign">
        <Exec Command="signtool.exe sign /f CertFile /p Password "@(FileToSign)" "/>
    </Target>

</Project>

Siehe auch

Konzepte

MSBuild-Aufgaben

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben