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šší.
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>