You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/deployment/troubleshooting-clickonce-deployments.md
+10-10Lines changed: 10 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -21,29 +21,29 @@ manager: douge
21
21
ms.workload:
22
22
- "multiple"
23
23
---
24
-
# Troubleshooting ClickOnce Deployments
24
+
# Troubleshoot ClickOnce deployments
25
25
This topic helps you diagnose and resolve the most common issues with [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] deployments.
26
26
27
27
In most cases, a [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] application will download to a user's computer and run without any problems. There are some cases, however, where Web server or application configuration issues can cause unforeseen problems.
28
28
29
-
[How to: Set a Custom Log File Location for ClickOnce Deployment Errors](../deployment/how-to-set-a-custom-log-file-location-for-clickonce-deployment-errors.md)
29
+
[How to: Set a custom log file location for ClickOnce deployment errors](../deployment/how-to-set-a-custom-log-file-location-for-clickonce-deployment-errors.md)
30
30
Describes how to redirect all [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] activation failures on a machine to a single log file.
31
31
32
-
[How to: Specify Verbose Log Files for ClickOnce Deployments](../deployment/how-to-specify-verbose-log-files-for-clickonce-deployments.md)
32
+
[How to: Specify verbose log files for ClickOnce deployments](../deployment/how-to-specify-verbose-log-files-for-clickonce-deployments.md)
33
33
Describes how to increase the detail that [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] writes to log files.
34
34
35
-
[Server and Client Configuration Issues in ClickOnce Deployments](../deployment/server-and-client-configuration-issues-in-clickonce-deployments.md)
35
+
[Server and client configuration issues in ClickOnce deployments](../deployment/server-and-client-configuration-issues-in-clickonce-deployments.md)
36
36
Describes various issues with the configuration of your Web server that could cause difficulty downloading [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] applications.
37
37
38
-
[Security, Versioning, and Manifest Issues in ClickOnce Deployments](../deployment/security-versioning-and-manifest-issues-in-clickonce-deployments.md)
38
+
[Security, versioning, and manifest issues in ClickOnce deployments](../deployment/security-versioning-and-manifest-issues-in-clickonce-deployments.md)
[Troubleshooting Specific Errors in ClickOnce Deployments](../deployment/troubleshooting-specific-errors-in-clickonce-deployments.md)
41
+
[Troubleshoot specific errors in ClickOnce deployments](../deployment/troubleshooting-specific-errors-in-clickonce-deployments.md)
42
42
Describes specific scenarios in which a [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] deployment cannot succeed, and provides steps for resolving them.
43
43
44
-
[Debugging ClickOnce Applications That Use System.Deployment.Application](../deployment/debugging-clickonce-applications-that-use-system-deployment-application.md)
44
+
[Debug ClickOnce applications that use System.Deployment.Application](../deployment/debugging-clickonce-applications-that-use-system-deployment-application.md)
45
45
Describes a technique for debugging ClickOnce applications that use System.Deployment.Application.
Copy file name to clipboardExpand all lines: docs/deployment/troubleshooting-specific-errors-in-clickonce-deployments.md
+10-10Lines changed: 10 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -22,15 +22,15 @@ manager: douge
22
22
ms.workload:
23
23
- "multiple"
24
24
---
25
-
# Troubleshooting Specific Errors in ClickOnce Deployments
25
+
# Troubleshoot specific errors in ClickOnce deployments
26
26
This article lists the following common errors that can occur when you deploy a [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] application, and provides steps to resolve each problem.
27
27
28
-
## General Errors
28
+
## General errors
29
29
30
30
#### When you try to locate an application file, nothing occurs, or XML renders in Internet Explorer, or you receive a Run or Save As dialog box
31
31
This error is likely caused by content types (also known as MIME types) not being registered correctly on the server or client.
32
32
33
-
First, make sure that the server is configured to associate the `.application` extension with content type "application/x-ms-application."
33
+
First, make sure that the server is configured to associate the *.application* extension with content type "application/x-ms-application."
34
34
35
35
If the server is configured correctly, check that the [!INCLUDE[dnprdnlong](../code-quality/includes/dnprdnlong_md.md)] is installed on your computer. If the [!INCLUDE[dnprdnlong](../code-quality/includes/dnprdnlong_md.md)] is installed, and you are still seeing this problem, try uninstalling and reinstalling the [!INCLUDE[dnprdnlong](../code-quality/includes/dnprdnlong_md.md)] to re-register the content type on the client.
36
36
@@ -48,11 +48,11 @@ This article lists the following common errors that can occur when you deploy a
48
48
- See whether there are network connectivity issues; you can receive this message if your client computer went offline during the download.
49
49
50
50
#### Download error when you try to install a ClickOnce application that has a .config file
51
-
By default, a Visual Basic Windows-based application includes an App.config file. There will be a problem when a user tries to install from a Web server that uses Windows Server 2003, because that operating system blocks the installation of .config files for security reasons. To enable the .config file to be installed, click **Use ".deploy" file extension** in the **Publish Options** dialog box.
51
+
By default, a Visual Basic Windows-based application includes an App.config file. There will be a problem when a user tries to install from a Web server that uses Windows Server 2003, because that operating system blocks the installation of *.config* files for security reasons. To enable the *.config* file to be installed, click **Use ".deploy" file extension** in the **Publish Options** dialog box.
52
52
53
53
You also must set the content types (also known as MIME types) appropriately for .application, .manifest, and .deploy files. For more information, see your Web server documentation.
54
54
55
-
For more information, see "Windows Server 2003: Locked-Down Content Types" in [Server and Client Configuration Issues in ClickOnce Deployments](../deployment/server-and-client-configuration-issues-in-clickonce-deployments.md).
55
+
For more information, see "Windows Server 2003: Locked-Down Content Types" in [Server and client configuration issues in ClickOnce deployments](../deployment/server-and-client-configuration-issues-in-clickonce-deployments.md).
56
56
57
57
#### Error message: "Application is improperly formatted;" Log file contains "XML signature is invalid"
58
58
Ensure that you updated the manifest file and signed it again. Republish your application by using [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] or use Mage to sign the application again.
@@ -97,10 +97,10 @@ This article lists the following common errors that can occur when you deploy a
97
97
98
98
If you are publishing with a URL, ensure that the destination computer has FrontPage Server Extensions enabled.
99
99
100
-
#### Error Message: Unable to create the Web site '\<site>'. The components for communicating with FrontPage Server Extensions are not installed.
100
+
#### Error message: Unable to create the Web site '\<site>'. The components for communicating with FrontPage Server Extensions are not installed.
101
101
Ensure that you have the Microsoft Visual Studio Web Authoring Component installed on the machine that you are publishing from. For Express users, this component is not installed by default. For more information, see [http://go.microsoft.com/fwlink/?LinkId=102310](http://go.microsoft.com/fwlink/?LinkId=102310).
102
102
103
-
#### Error Message: Could not find file 'Microsoft.Windows.Common-Controls, Version=6.0.0.0, Culture=*, PublicKeyToken=6595b64144ccf1df, ProcessorArchitecture=\*, Type=win32'
103
+
#### Error message: Could not find file 'Microsoft.Windows.Common-Controls, Version=6.0.0.0, Culture=*, PublicKeyToken=6595b64144ccf1df, ProcessorArchitecture=\*, Type=win32'
104
104
This error message appears when you attempt to publish a WPF application with visual styles enabled. To resolve this issue, see [How to: Publish a WPF Application with Visual Styles Enabled](../deployment/how-to-publish-a-wpf-application-with-visual-styles-enabled.md).
105
105
106
106
## Using Mage
@@ -132,6 +132,6 @@ This article lists the following common errors that can occur when you deploy a
132
132
|Shortcuts cannot be activated over the network.|Shortcuts to a [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] application can only be started on the local hard disk. They cannot be started by opening a URL that points to a shortcut file on a remote server.|
133
133
|The application is too large to run online in partial trust. Contact the application vendor or your system administrator for assistance.|An application that runs in partial trust cannot be larger than half of the size of the online application quota, which by default is 250 MB.|
134
134
135
-
## See Also
136
-
[ClickOnce Security and Deployment](../deployment/clickonce-security-and-deployment.md)
Copy file name to clipboardExpand all lines: docs/deployment/trusted-application-deployment-overview.md
+10-10Lines changed: 10 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -19,15 +19,15 @@ manager: douge
19
19
ms.workload:
20
20
- "multiple"
21
21
---
22
-
# Trusted Application Deployment Overview
22
+
# Trusted Application Deployment overview
23
23
This topic provides an overview of how to deploy [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] applications that have elevated permissions by using the Trusted Application Deployment technology.
24
24
25
25
Trusted Application Deployment, part of the [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] deployment technology, makes it easier for organizations of any size to grant additional permissions to a managed application in a safer, more secure manner without user prompting. With Trusted Application Deployment, an organization can just configure a client computer to have a list of trusted publishers, who are identified using Authenticode certificates. Thereafter, any [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] application signed by one of these trusted publishers receives a higher level of trust.
26
26
27
27
> [!NOTE]
28
28
> Trusted Application Deployment requires one-time configuration of a user's computer. In managed desktop environments, this configuration can be performed by using global policy. If this is not what you want for your application, use permission elevation instead. For more information, see [Securing ClickOnce Applications](../deployment/securing-clickonce-applications.md).
29
29
30
-
## Trusted Application Deployment Basics
30
+
## Trusted Application Deployment basics
31
31
The following table shows the objects and roles that are involved in Trusted Application Deployment.
32
32
33
33
|Object or role|Description|
@@ -61,10 +61,10 @@ This topic provides an overview of how to deploy [!INCLUDE[ndptecclick](../deplo
61
61
62
62
5. Publish the application deployment to client computers.
63
63
64
-
### Obtain a Certificate for the Publisher
64
+
### Obtain a certificate for the publisher
65
65
Digital certificates are a core component of the Microsoft Authenticode authentication and security system. Authenticode is a standard part of the Windows operating system. All [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] applications must be signed with a digital certificate, regardless of whether they participate in Trusted Application Deployment. For a full explanation of how Authenticode works with [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)], see [ClickOnce and Authenticode](../deployment/clickonce-and-authenticode.md).
66
66
67
-
### Add the Publisher to the Trusted Publishers Store
67
+
### Add the publisher to the trusted publishers store
68
68
For your [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] application to receive a higher level of trust, you must add your certificate as a trusted publisher to each client computer on which the application will run. Performing this task is a one-time configuration. After it is completed, you can deploy as many [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] applications signed with your publisher's certificate as you want, and they will all run with high trust.
69
69
70
70
If you are deploying your application in a managed desktop environment; for example, a corporate intranet running the Windows operating system; you can add trusted publishers to a client's store by creating a new certificate trust list (CTL) with Group Policy. For more information, see [Create a certificate trust list for a Group Policy object](http://go.microsoft.com/fwlink/?LinkId=102576).
@@ -73,22 +73,22 @@ This topic provides an overview of how to deploy [!INCLUDE[ndptecclick](../deplo
73
73
74
74
- The <xref:System.Security.Cryptography?displayProperty=fullName> namespace.
75
75
76
-
- CertMgr.exe, which is a component of Internet Explorer and therefore exists on Windows 98 and all later versions. For more information, see [Certmgr.exe (Certificate Manager Tool)](/dotnet/framework/tools/certmgr-exe-certificate-manager-tool).
76
+
-*CertMgr.exe*, which is a component of Internet Explorer and therefore exists on Windows 98 and all later versions. For more information, see [Certmgr.exe (Certificate Manager Tool)](/dotnet/framework/tools/certmgr-exe-certificate-manager-tool).
77
77
78
78
### Create a ClickOnce Application
79
79
A [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] application is a [!INCLUDE[dnprdnshort](../code-quality/includes/dnprdnshort_md.md)] client application combined with manifest files that describe the application and supply installation parameters. You can turn your program into a [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] application by using the **Publish** command in [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)]. Alternatively, you can generate all the files required for [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] deployment by using tools that are included with the [!INCLUDE[winsdklong](../deployment/includes/winsdklong_md.md)]. For detailed steps about [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] deployment, see [Walkthrough: Manually Deploying a ClickOnce Application](../deployment/walkthrough-manually-deploying-a-clickonce-application.md).
80
80
81
81
Trusted Application Deployment is specific to [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)], and can only be used with [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] applications.
82
82
83
-
### Sign the Deployment
83
+
### Sign the deployment
84
84
After obtaining your certificate, you must use it to sign your deployment. If you are deploying your application by using the [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] Publish wizard, the wizard will automatically generate a test certificate for you if you have not specified a certificate yourself. You can also use the [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] Project Designer window, however, to supply a certificate provided by a CA. Also see [How to: Publish a ClickOnce Application using the Publish Wizard](../deployment/how-to-publish-a-clickonce-application-using-the-publish-wizard.md).
85
85
86
86
> [!CAUTION]
87
87
> We do not recommend that the application be deployed with a test certificate.
88
88
89
-
You can also sign the application by using the Mage.exe or MageUI.exe SDK tools. For more information, see [Walkthrough: Manually Deploying a ClickOnce Application](../deployment/walkthrough-manually-deploying-a-clickonce-application.md). For a full list of command-line options related to deployment signing, see [Mage.exe (Manifest Generation and Editing Tool)](/dotnet/framework/tools/mage-exe-manifest-generation-and-editing-tool).
89
+
You can also sign the application by using the *Mage.exe* or *MageUI.exe* SDK tools. For more information, see [Walkthrough: Manually deploy a ClickOnce application](../deployment/walkthrough-manually-deploying-a-clickonce-application.md). For a full list of command-line options related to deployment signing, see [Mage.exe (Manifest Generation and Editing Tool)](/dotnet/framework/tools/mage-exe-manifest-generation-and-editing-tool).
90
90
91
-
### Publish the Application
91
+
### Publish the application
92
92
As soon as you have signed your [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] manifests, the application is ready to publish to your install location. The installation location can be a Web server, a file share, or the local disk. When a client accesses the deployment manifest for the first time, the trust manager must choose whether the [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] application has been granted authority or not to run at a higher level of trust by an installed trusted publisher. The trust manager makes this choice by comparing the certificate used to sign the deployment with the certificates stored in the client's trusted publisher store. If the trust manager finds a match, the application runs with high trust.
93
93
94
94
## Trusted Application Deployment and Permission Elevation
@@ -97,6 +97,6 @@ This topic provides an overview of how to deploy [!INCLUDE[ndptecclick](../deplo
97
97
## Limitations of Trusted Application Deployment
98
98
You can use Trusted Application Deployment to grant elevated trust to [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] applications deployed over the Web or through an enterprise file share. You do not have to use Trusted Application Deployment for [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] applications distributed on a CD, because, by default, these applications are granted full trust.
99
99
100
-
## See Also
100
+
## See also
101
101
[Mage.exe (Manifest Generation and Editing Tool)](/dotnet/framework/tools/mage-exe-manifest-generation-and-editing-tool)
102
-
[Walkthrough: Manually Deploying a ClickOnce Application](../deployment/walkthrough-manually-deploying-a-clickonce-application.md)
102
+
[Walkthrough: Manually deploy a ClickOnce application](../deployment/walkthrough-manually-deploying-a-clickonce-application.md)
0 commit comments