Skip to content

Commit e84d71e

Browse files
committed
(#1117) Update client setup documentation with new parameterization options
This commit adds new documentation about the parameters that are available to pass as part of registering a new endpoint into the Chocolatey solution.
1 parent 584a87f commit e84d71e

File tree

1 file changed

+15
-1
lines changed

1 file changed

+15
-1
lines changed

src/content/docs/en-us/c4b-environments/quick-start-environment/chocolatey-for-business-quick-start-guide.mdx

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -283,7 +283,7 @@ export const callout4 = {
283283
```powershell
284284
Set-ExecutionPolicy Bypass -Scope Process -Force
285285
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::tls12
286-
.\Register-C4bEndpoint.ps1
286+
.\Register-C4bEndpoint.ps1 -RepositoryCredential (Get-Credential) # Will prompt for username and password. Values found in README on Server Desktop.
287287
```
288288

289289
> <details>
@@ -300,6 +300,20 @@ export const callout4 = {
300300
> </ul>
301301
> </details>
302302
303+
#### Available parameters
304+
305+
* `ClientCommunicationSalt` - Chocolatey Central Management Client Communication Salt Additive - The salt additive to use in the salt recipe for encrypting and verifying communication from an agent TO an instance of Central Management Service (will need to be set the same on all clients contacting that service AND the instance of the management service itself). When not set a default encryption phrase set by the system will be used. When set the unencrypted value must match exactly with what is set in the configuration for Central Management Service and every client contacting that instance of Central Management Service. Value is not shared over the wire. Because this is a much more involved process, it is recommended only setting this if you are transmitting messages over the internet. Defaults to ''. Needs to be at least 8 characters long if set or it will throw errors and use the default. Available in business editions only. IMPORTANT: If this value is set, agents less than v0.10.0 will be unable to contact Central Management to report in.
306+
* `ServiceCommunicationSalt` -Chocolatey Central Management Service Communication Salt Additive - The salt additive to use in the salt recipe for encrypting and verifying communication FROM an instance of Central Management Service to an agent (will need to be set the same on all clients contacting that service AND the instance of the management service itself). When not set a default encryption phrase set by the system will be used. When set the unencrypted value must match exactly with what is set in the configuration for Central Management Service and every client contacting that instance of Central Management Service. Value is not shared over the wire. Because this is a much more involved process, it is recommended only setting this if you are transmitting messages over the internet. Defaults to ''. Needs to be at least 8 characters long if set or it will throw errors and use the default. Available in business editions only.
307+
* `RepositoryCredential` - The credential to use to access the repository server from the endpoint. Details available from README file on server desktop.
308+
* `ProxyUrl` - The URL of a proxy server to use for connecting to the repository.
309+
* `ProxyCredential` - The credentials, if required, to connect to the proxy server.
310+
* `IncludePackageTools` - Install the Chocolatey Licensed Extension with right-click context menus available
311+
* `AdditionalConfiguration` - Allows for the application of user-defined configuration that is applied after the base configuration.
312+
* `AdditionalFeatures` - Allows for the toggling of additional features that is applied after the base configuration.
313+
* `AdditionalPackages` - Allows for the installation of additional packages after the system base packages have been installed.
314+
* `AdditionalSources` - Allows for the addition of alternative sources after the base configuration has been applied.
315+
* `TrustCertificate` - If passed, downloads the certificate from the client server before initializing Chocolatey Agent
316+
303317
### Conclusion
304318

305319
Congratulations! If you followed all the steps detailed above, you should now have a fully functioning Chocolatey for Business implementation deployed in your environment.

0 commit comments

Comments
 (0)