Sdílet prostřednictvím


SignFile – úloha

Přihlásí zadaný soubor pomocí zadaného certifikátu.

Parametry

Následující tabulka popisuje parametry SignFile úloh.

Všimněte si, že jsou certifikáty SHA-256 povoleno pouze v počítačích, které mají .NET 4.5 a vyšší.

Poznámka k upozorněníUpozornění

Tato úloha spuštění v aplikaci Visual Studio 2013 Update 3, má nový podpis, který slouží k zadání cílové verze framework pro soubor.Jste nový podpis používají, je-li to možné, protože proces MSBuild využívá SHA-256 hashuje pouze v případě, že Cílová architektura je .NET 4.5 nebo vyšší.Pokud je cílové rozhraní .NET 4.0 nebo pod hodnotu hash SHA-256 nebudou použity.

Parametr

Popis

CertificateThumbprint

Požadovaný parametr String.

Určuje certifikát, který má být použit pro podepisování.Tento certifikát musí být v osobním úložišti aktuálního uživatele.

SigningTarget

Požadovaný parametr ITaskItem.

Určuje soubory, které se přihlásit s certifikátem.

TimestampUrl

Volitelný String parametru.

Určuje adresu URL časového razítka serveru.

TargetFrameworkVersion

Verze rozhraní .NET Framework, který se používá pro cíl.

Poznámky

Kromě výše uvedených parametrů, tato úloha dědí parametrů z Task třídy.Seznam tyto další parametry a jejich popisy naleznete v tématu Třída Base úlohy.

Příklad

V následujícím příkladu SignFile úkol podepsat soubory uvedené v seznamu FilesToSign položku kolekce s certifikát určený na základě Certificate vlastnost.

<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)" 
            TargetFrameworkVersion="v4.5" />
    </Target>
</Project>

[!POZNÁMKA]

Kryptografický otisk certifikátu je hash SHA-1 certifikátu.Další informace naleznete v tématu získat hodnotu Hash SHA-1 certifikát důvěryhodné kořenové Certifikační autority.

V následujícím příkladu Exec úkol podepsat soubory uvedené v seznamu FilesToSign položku kolekce s certifikát určený na základě Certificate vlastnost.Můžete to k podepisování souborů Instalační služby systému Windows během procesu sestavení.

<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)" "/>
        <SignFile
            CertificateThumbprint="$(CertificateThumbprint)"
            SigningTarget="@(FileToSign)" 
            TargetFrameworkVersion="v4.0" />
    </Target>
</Project>

Viz také

Koncepty

Úlohy nástroje MSBuild

Další zdroje

Referenční dokumentace úlohy nástroje MSBuild