From aeca599c1eca51c3f2d74df9843d40b4a39c3610 Mon Sep 17 00:00:00 2001 From: David Boike Date: Fri, 13 Oct 2023 16:48:44 -0500 Subject: [PATCH 1/2] Remove PowerShell module from installer --- src/ServiceControl.sln | 15 - .../Properties/launchSettings.json | 10 - .../ServiceControlInstaller.PowerShell.csproj | 60 - ...ceControlInstaller.Powershell.dll-help.xml | 3592 ----------------- .../ServiceControlMgmt.format.ps1xml | 31 - .../ServiceControlMgmt.psd1 | 17 - .../ServiceControlMgmt.psm1 | 50 - .../ShortcutStartup.ps1 | 16 - src/Setup/ServiceControl.aip | 179 +- src/Setup/Setup.csproj | 1 - 10 files changed, 34 insertions(+), 3937 deletions(-) delete mode 100644 src/ServiceControlInstaller.PowerShell/Properties/launchSettings.json delete mode 100644 src/ServiceControlInstaller.PowerShell/ServiceControlInstaller.PowerShell.csproj delete mode 100644 src/ServiceControlInstaller.PowerShell/ServiceControlInstaller.Powershell.dll-help.xml delete mode 100644 src/ServiceControlInstaller.PowerShell/ServiceControlMgmt.format.ps1xml delete mode 100644 src/ServiceControlInstaller.PowerShell/ServiceControlMgmt.psd1 delete mode 100644 src/ServiceControlInstaller.PowerShell/ServiceControlMgmt.psm1 delete mode 100644 src/ServiceControlInstaller.PowerShell/ShortcutStartup.ps1 diff --git a/src/ServiceControl.sln b/src/ServiceControl.sln index 7155f379e0..2c6de35bad 100644 --- a/src/ServiceControl.sln +++ b/src/ServiceControl.sln @@ -10,8 +10,6 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Installer", "Installer", "{ EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ServiceControlInstaller.Engine", "ServiceControlInstaller.Engine\ServiceControlInstaller.Engine.csproj", "{E2F41605-F664-4EC6-9D64-1F142CC3B7B2}" EndProject -Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ServiceControlInstaller.PowerShell", "ServiceControlInstaller.PowerShell\ServiceControlInstaller.PowerShell.csproj", "{FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}" -EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ServiceControlInstaller.CustomActions", "ServiceControlInstaller.CustomActions\ServiceControlInstaller.CustomActions.csproj", "{2343779D-26D4-4F9D-A42F-32E146632EF0}" EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ServiceControlInstaller.Packaging", "ServiceControlInstaller.Packaging\ServiceControlInstaller.Packaging.csproj", "{15F811B7-314C-4E9E-B5E9-35596045BBC4}" @@ -223,18 +221,6 @@ Global {E2F41605-F664-4EC6-9D64-1F142CC3B7B2}.Release|x64.Build.0 = Release|Any CPU {E2F41605-F664-4EC6-9D64-1F142CC3B7B2}.Release|x86.ActiveCfg = Release|Any CPU {E2F41605-F664-4EC6-9D64-1F142CC3B7B2}.Release|x86.Build.0 = Release|Any CPU - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}.Debug|Any CPU.Build.0 = Debug|Any CPU - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}.Debug|x64.ActiveCfg = Debug|Any CPU - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}.Debug|x64.Build.0 = Debug|Any CPU - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}.Debug|x86.ActiveCfg = Debug|Any CPU - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}.Debug|x86.Build.0 = Debug|Any CPU - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}.Release|Any CPU.ActiveCfg = Release|Any CPU - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}.Release|Any CPU.Build.0 = Release|Any CPU - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}.Release|x64.ActiveCfg = Release|Any CPU - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}.Release|x64.Build.0 = Release|Any CPU - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}.Release|x86.ActiveCfg = Release|Any CPU - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7}.Release|x86.Build.0 = Release|Any CPU {2343779D-26D4-4F9D-A42F-32E146632EF0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU {2343779D-26D4-4F9D-A42F-32E146632EF0}.Debug|Any CPU.Build.0 = Debug|Any CPU {2343779D-26D4-4F9D-A42F-32E146632EF0}.Debug|x64.ActiveCfg = Debug|Any CPU @@ -995,7 +981,6 @@ Global {4F65FAE1-4C51-4BEF-956E-97C6A96807F9} = {350F72AB-142D-4AAD-9EF1-1A83DC991D87} {4C6B71B2-74EF-4B9E-88FF-C56532727C6D} = {CD6E567B-C17B-4C90-87CA-F6CB941EC307} {E2F41605-F664-4EC6-9D64-1F142CC3B7B2} = {55C388DD-2B39-4C2F-AEBD-AFD3444815F1} - {FA9439BF-37B4-4F27-B7E9-BE3605E66BE7} = {55C388DD-2B39-4C2F-AEBD-AFD3444815F1} {2343779D-26D4-4F9D-A42F-32E146632EF0} = {55C388DD-2B39-4C2F-AEBD-AFD3444815F1} {15F811B7-314C-4E9E-B5E9-35596045BBC4} = {55C388DD-2B39-4C2F-AEBD-AFD3444815F1} {C0EEF6D1-5DF7-4A26-9964-6376F465B085} = {55C388DD-2B39-4C2F-AEBD-AFD3444815F1} diff --git a/src/ServiceControlInstaller.PowerShell/Properties/launchSettings.json b/src/ServiceControlInstaller.PowerShell/Properties/launchSettings.json deleted file mode 100644 index 8e5db7680c..0000000000 --- a/src/ServiceControlInstaller.PowerShell/Properties/launchSettings.json +++ /dev/null @@ -1,10 +0,0 @@ -{ - "profiles": { - "ServiceControlInstaller.PowerShell": { - "commandName": "Executable", - "executablePath": "%SystemRoot%\\system32\\WindowsPowerShell\\v1.0\\powershell.exe", - "commandLineArgs": - "-noexit -command \"&{ Push-Location \\\"C:\\Particular\\ServiceControl\\zip\\\" \"; import-module .\\ServiceControlInstaller.PowerShell.dll -verbose}\"" - } - } -} \ No newline at end of file diff --git a/src/ServiceControlInstaller.PowerShell/ServiceControlInstaller.PowerShell.csproj b/src/ServiceControlInstaller.PowerShell/ServiceControlInstaller.PowerShell.csproj deleted file mode 100644 index 769485ec98..0000000000 --- a/src/ServiceControlInstaller.PowerShell/ServiceControlInstaller.PowerShell.csproj +++ /dev/null @@ -1,60 +0,0 @@ - - - - net472 - 10.0 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0) - { - for (int i = 0; i < Files.Length; i++) - { - string path = Files[i].GetMetadata("FullPath"); - File.WriteAllText(path, Regex.Replace(File.ReadAllText(path), Pattern, ReplacementText, options)); - } - } - ]]> - - - - - - - - - - - - \ No newline at end of file diff --git a/src/ServiceControlInstaller.PowerShell/ServiceControlInstaller.Powershell.dll-help.xml b/src/ServiceControlInstaller.PowerShell/ServiceControlInstaller.Powershell.dll-help.xml deleted file mode 100644 index 3704585480..0000000000 --- a/src/ServiceControlInstaller.PowerShell/ServiceControlInstaller.Powershell.dll-help.xml +++ /dev/null @@ -1,3592 +0,0 @@ - - - - - - Get-ServiceControlMgmtCommands - - List ServiceControl Management Commands - - - - - Get - ServiceControlMgmtCommands - - - - List ServiceControl Management Commands - - - - Get-ServiceControlMgmtCommands - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Add-UrlAcl - - Add a URLACL reservation to the system. - - - - - Add - UrlAcl - - - - Adds a URLACL reservation to the system, this action requires Admin privileges. This can be achieved by using NETSH.EXE as well (See related links). - - - - Add-UrlAcl - - Url - - The URL to add to the URLACL list. The parameter must have a trailing slash to be considered valid. - - String - - - Users - - The user or group to assign to this URLACL. - - String[] - - - - - - Url - - The URL to add to the URLACL list. The parameter must have a trailing slash to be considered valid. - - String - - String - - - - - - Users - - The user or group to assign to this URLACL. - - String[] - - String[] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -------------------------- Example 1 -------------------------- - - PS C:\> - - - #Add a URL ACL for the default ServiceControl port - Add-UrlAcl -url http://localhost:33333/api/ -users Builtin\Users - - - - - - - - - - - - - - - - - - - https://msdn.microsoft.com/en-us/library/windows/desktop/cc307236%28v=vs.85%29.aspx - - - - - - - - Get-AuditInstances - - List the currently configured ServiceControl Audit instances. - - - - - Get - AuditInstances - - - - List the currently configured ServiceControl Audit instances. - - - - Get-AuditInstances - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Get-MonitoringInstances - - List the currently configured ServiceControl instances. - - - - - Get - MonitoringInstances - - - - List the currently configured ServiceControl instances. - - - - Get-MonitoringInstances - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Get-SecurityIdentifier - - Get the Security Identifier (SID) for a User or Group. - - - - - Get - SecurityIdentifier - - - - Get the Security Identifier (SID) for a User or Group. The cmdlet will process one or more users if passed an array. - - - - Get-SecurityIdentifier - - UserName - - - Username can be the short name for a local user. e.g Administator - Or Username can specified in the longer form which specifies a user belonging to a domain or computer. e.g. MyComputer\Administrator - - - String[] - - - - - - UserName - - - Username can be the short name for a local user. e.g Administator - Or Username can specified in the longer form which specifies a user belonging to a domain or computer. e.g. MyComputer\Administrator - - - String[] - - String[] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -------------------------- Example 1 -------------------------- - - PS C:\> - - - # Get the sid for the Users group - Get-SecurityIdentifier Builtin\Users - - - - - - - - - - - - - - - - - -------------------------- Example 2 -------------------------- - - PS C:\> - - - # Get the sid for the NetworkService Account - Get-SecurityIdentifier NetworkService - - - - - - - - - - - - - - - - - -------------------------- Example 3 -------------------------- - - PS C:\> - - - # Get the sid for the LocalSystem Account - Get-SecurityIdentifier System - - - - - - - - - - - - - - - - - -------------------------- Example 4 -------------------------- - - PS C:\> - - - # Get the sid for the Foo user in MyDomain - Get-SecurityIdentifier MyDomain\Foo - - - - - - - - - - - - - - - - - - - - - - - Get-ServiceControlInstances - - List the currently configured ServiceControl instances. - - - - - Get - ServiceControlInstances - - - - List the currently configured ServiceControl instances. - - - - Get-ServiceControlInstances - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -------------------------- Example 1 -------------------------- - - PS C:\> - - - # List All - Get-ServiceControlInstances - - - - - - - - - - - - - - - - - - - - - - - Get-ServiceControlLicense - - Look for ServiceControl Licenses. - - - - - Get - ServiceControlLicense - - - - Looks for existing ServiceControl License(s) and displays info about it. - - - - Get-ServiceControlLicense - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Get-ServiceControlTransportTypes - - List transport types supported by ServiceControl. - - - - - Get - ServiceControlTransportTypes - - - - List transport types which can be used when setting configuration information in ServiceControl. - - - - Get-ServiceControlTransportTypes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -------------------------- Example 1 -------------------------- - - PS C:\> - - Get-ServiceControlTransportTypes - - - - - - - - - - - - - - - - -------------------------- Example 2 -------------------------- - - PS C:\> - - - # List with more detail - Get-ServiceControlTransportTypes | Select -Property * - - - - - - - - - - - - - - - - - - - - - - - Get-UrlAcls - - List all registered URLACLs. - - - - - Get - UrlAcls - - - - List all registered URLACLs. The listed entries can be used to diagnose URLACL issues which may prevent ServiceControl from starting. If you require a more feature rich tool for managing URLACLs please take a look at NETSH.EXE. - - - - Get-UrlAcls - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - https://msdn.microsoft.com/en-us/library/windows/desktop/cc307236%28v=vs.85%29.aspx - - - - - - - - Import-ServiceControlLicense - - Imports the Particular Platform License into the Registry. - - - - - Import - ServiceControlLicense - - - - Imports the Platform License into the Windows Registry for use by ServiceControl. - - - - Import-ServiceControlLicense - - File - - The path to the license file that will be imported. The license file is written to the following location in the registry: HKEY_LOCAL_MACHINE\SOFTWARE\ParticularSoftware\License - - String - - - - - - File - - The path to the license file that will be imported. The license file is written to the following location in the registry: HKEY_LOCAL_MACHINE\SOFTWARE\ParticularSoftware\License - - String - - String - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -------------------------- Example 1 -------------------------- - - PS C:\> - - Import-ServiceControlLicense -File c:\temp\license.xml - - - - - - - - - - - - - - - - - - - - - - Invoke-AuditInstanceUpgrade - - Upgrade an instance of the ServiceControl Audit service to the version that shipped with this installation. - - - - - Invoke - AuditInstanceUpgrade - - - - Upgrade an instance of the ServiceControl Audit service to the version that shipped with this installation. - - - - Invoke-AuditInstanceUpgrade - - SkipQueueCreation - - Normally an instance will attempt to create the queues that it uses. If this flag is set, queue creation will be skipped. - - SwitchParameter - - - Name - - Name of the ServiceControl Audit Service to upgrade. This corresponds to the Windows Service Name for the service not the Display Name. - - String[] - - - - - - SkipQueueCreation - - Normally an instance will attempt to create the queues that it uses. If this flag is set, queue creation will be skipped. - - SwitchParameter - - SwitchParameter - - - - - - Name - - Name of the ServiceControl Audit Service to upgrade. This corresponds to the Windows Service Name for the service not the Display Name. - - String[] - - String[] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Invoke-MonitoringInstanceUpgrade - - Upgrade an instance of ServiceControl Monitoring service to the version that shipped with this installation. - - - - - Invoke - MonitoringInstanceUpgrade - - - - Upgrade an instance of ServiceControl Monitoring service to the version that shipped with this installation. - - - - Invoke-MonitoringInstanceUpgrade - - SkipQueueCreation - - Normally an instance will attempt to create the queues that it uses. If this flag is set, queue creation will be skipped. - - SwitchParameter - - - Name - - Name of the ServiceControl Monitoring service to upgrade. This corresponds to the Windows Service Name for the service not the Display Name. - - String[] - - - - - - SkipQueueCreation - - Normally an instance will attempt to create the queues that it uses. If this flag is set, queue creation will be skipped. - - SwitchParameter - - SwitchParameter - - - - - - Name - - Name of the ServiceControl Monitoring service to upgrade. This corresponds to the Windows Service Name for the service not the Display Name. - - String[] - - String[] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Invoke-ServiceControlInstanceConvert - - Convert a ServiceControl instance into a ServiceControl Audit instance - - - - - Invoke - ServiceControlInstanceConvert - - - - Convert a ServiceControl instance into a ServiceControl Audit instance - - - - Invoke-ServiceControlInstanceConvert - - ServiceControlAddress - - The transport address of the main ServiceControl instance to report new endpoints, custom checks results, and successful retry detection to. - - String - - - ServiceAccountPassword - - - The password for the service account that is being used for the existing ServiceControl instance - This only needs to be supplied if the service is not running as Local System, Local Service, or a Service Account - - - String - - - Name - - The name of the ServiceControl instance to convert - - String - - - - - - ServiceControlAddress - - The transport address of the main ServiceControl instance to report new endpoints, custom checks results, and successful retry detection to. - - String - - String - - - - - - ServiceAccountPassword - - - The password for the service account that is being used for the existing ServiceControl instance - This only needs to be supplied if the service is not running as Local System, Local Service, or a Service Account - - - String - - String - - - - - - Name - - The name of the ServiceControl instance to convert - - String - - String - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Invoke-ServiceControlInstanceSplit - - Split an Audit Instance out of an existing ServiceControl instance. - - - - - Invoke - ServiceControlInstanceSplit - - - - Split an Audit Instance out of an existing ServiceControl instance. - - - - Invoke-ServiceControlInstanceSplit - - InstallPath - - The directory to use for the new ServiceControl Audit Instance. The binary files are copied here. This directory should be empty or not exist and the path should not be a subfolder of the DBPath or LogPath - - String - - - DBPath - - The directory that will contain the embedded database files for the new ServiceControl Audit Instance. This should be unique for each instance of ServiceControl and should not be a subfolder of the InstallPath or LogPath. - - String - - - LogPath - - The directory that will contain the logs for the new instance of ServiceControl Audit. This should be empty or not exist and should not be a subfolder of the InstallPath. - - String - - - Port - - - The TCP port number for the new Audit Instance to listen on. The port number must be unique for each instance and not be in use by another process. Use the Test-IfPortIsAvailable cmdlet to verify a port number is free. - The allowed port range is 1 to 49151. - - - Int32 - - - DatabaseMaintenancePort - - The name of the main ServiceControl instance to split the Audit instance out of - - Int32 - - - ServiceAccountPassword - - - - String - - - Force - - Force the installation even if the directories specified are not empty - - SwitchParameter - - - Name - - - The name of the main ServiceControl instance to split the Audit Instance out of. - The named instance will be updated to the latest version. - - - String - - - - - - InstallPath - - The directory to use for the new ServiceControl Audit Instance. The binary files are copied here. This directory should be empty or not exist and the path should not be a subfolder of the DBPath or LogPath - - String - - String - - - - - - DBPath - - The directory that will contain the embedded database files for the new ServiceControl Audit Instance. This should be unique for each instance of ServiceControl and should not be a subfolder of the InstallPath or LogPath. - - String - - String - - - - - - LogPath - - The directory that will contain the logs for the new instance of ServiceControl Audit. This should be empty or not exist and should not be a subfolder of the InstallPath. - - String - - String - - - - - - Port - - - The TCP port number for the new Audit Instance to listen on. The port number must be unique for each instance and not be in use by another process. Use the Test-IfPortIsAvailable cmdlet to verify a port number is free. - The allowed port range is 1 to 49151. - - - Int32 - - Int32 - - - - - - DatabaseMaintenancePort - - The name of the main ServiceControl instance to split the Audit instance out of - - Int32 - - Int32 - - - - - - ServiceAccountPassword - - - - String - - String - - - - - - Force - - Force the installation even if the directories specified are not empty - - SwitchParameter - - SwitchParameter - - - - - - Name - - - The name of the main ServiceControl instance to split the Audit Instance out of. - The named instance will be updated to the latest version. - - - String - - String - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Invoke-ServiceControlInstanceUpgrade - - Upgrade an instance of the ServiceControl service to the version that shipped with this installation. - - - - - Invoke - ServiceControlInstanceUpgrade - - - - Upgrade an instance of the ServiceControl service to the version that shipped with this installation. - - - - Invoke-ServiceControlInstanceUpgrade - - AuditRetentionPeriod - - - AuditRetentionPeriod controls how long ServiceControl retains messages ingested from the Audit queue in the database. The value must be a TimeSpan within the range 1 hour to 365 days. - Use the New-TimeSpan cmdlet to generate a TimeSpan value. - - - Nullable`1[TimeSpan] - - - ErrorRetentionPeriod - - - ErrorRetentionPeriod controls how long ServiceControl retains messages ingested from the Error queue in the database. Only error messages that have been successfully retried or marked as resolved are purged. - The value must be a TimeSpan within the range 5 days to 45 days. Use the New-TimeSpan cmdlet to generate a TimeSpan value. - - - Nullable`1[TimeSpan] - - - SkipQueueCreation - - Normally an instance will attempt to create the queues that it uses. If this flag is set, queue creation will be skipped. - - SwitchParameter - - - DatabaseMaintenancePort - - - - Int32 - - - Name - - Name of the ServiceControl Service to upgrade. This corresponds to the Windows Service Name for the service not the Display Name. - - String[] - - - ForwardErrorMessages - - This parameter is mandatory if the existing instance of ServiceControl does not have an entry in the configuration file for ForwardErrorMessages. When enabled all messages read of the Error queue are forwarded to queue specified ErrorLog queue as part of the import into ServiceControl. This configuration settings did not exist prior to Version of 1.12. - - Nullable`1[Boolean] - - - - - - AuditRetentionPeriod - - - AuditRetentionPeriod controls how long ServiceControl retains messages ingested from the Audit queue in the database. The value must be a TimeSpan within the range 1 hour to 365 days. - Use the New-TimeSpan cmdlet to generate a TimeSpan value. - - - Nullable`1[TimeSpan] - - Nullable`1[TimeSpan] - - - - - - ErrorRetentionPeriod - - - ErrorRetentionPeriod controls how long ServiceControl retains messages ingested from the Error queue in the database. Only error messages that have been successfully retried or marked as resolved are purged. - The value must be a TimeSpan within the range 5 days to 45 days. Use the New-TimeSpan cmdlet to generate a TimeSpan value. - - - Nullable`1[TimeSpan] - - Nullable`1[TimeSpan] - - - - - - SkipQueueCreation - - Normally an instance will attempt to create the queues that it uses. If this flag is set, queue creation will be skipped. - - SwitchParameter - - SwitchParameter - - - - - - DatabaseMaintenancePort - - - - Int32 - - Int32 - - - - - - Name - - Name of the ServiceControl Service to upgrade. This corresponds to the Windows Service Name for the service not the Display Name. - - String[] - - String[] - - - - - - ForwardErrorMessages - - This parameter is mandatory if the existing instance of ServiceControl does not have an entry in the configuration file for ForwardErrorMessages. When enabled all messages read of the Error queue are forwarded to queue specified ErrorLog queue as part of the import into ServiceControl. This configuration settings did not exist prior to Version of 1.12. - - Nullable`1[Boolean] - - Nullable`1[Boolean] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - New-AuditInstance - - Add a new instance of ServiceControl Audit service. - - - - - New - AuditInstance - - - - Add a new instance of ServiceControl Audit and registers it as Windows Service. - - - - New-AuditInstance - - Name - - The name of the ServiceControl Audit instance. This will be used as the Windows Service Name. The name must be unique for all Windows services and not contain any spaces or special characters. - - String - - - InstallPath - - The directory to use for this ServiceControl Audit Instance. The binary files are copied here. This directory should be empty or not exist and the path should not be a subfolder of the DBPath or LogPath - - String - - - DBPath - - The directory that will contain the embedded database files for this ServiceControl Audit Instance. This should be unique for each instance of ServiceControl and should not be a subfolder of the InstallPath or LogPath. - - String - - - LogPath - - The directory that will contain the logs for this instance of ServiceControl Audit. This should be empty or not exist and should not be a subfolder of the InstallPath. - - String - - - HostName - - - The hostname to use in the URLACL. Values for hostname can be localhost, the fully qualified DNS name fo teh computer or the wildcard character '*' . If localhost is used the URL will only be accessible locally, - WARNING: The default value is localhost. Consider carefully the implications of exposing ServiceControl Audit via a custom or wildcard URL. There is no inbuilt security so all messages stroed will be accessable using anonymous access. - - - String - - - Port - - - The TCP port number to listen on. The port number must be unique for each instance and not be in use by another process. Use the Test-IfPortIsAvailable cmdlet to verify a port number is free. - The allowed port range is 1 to 49151. - - - Int32 - - - DatabaseMaintenancePort - - - - Int32 - - - AuditQueue - - Specifies the input queue name to consume audit messages from. - - String - - - AuditLogQueue - - The queue that audit messages will be forwarded to if ForwardAuditMessages is enabled. See ForwardAuditMessages for more information. - - String - - - Transport - - - The name of the NServiceBus Transport to use. e.g. "AzureServiceBus", "AzureStorageQueue", "MSMQ", "SQLServer" or "RabbitMQ". - Execute 'Get-ServiceControlTransportTypes | Select -Property Name' to retrieve the full list of valid transports. - - - String - - - DisplayName - - Specify the Windows Service Display name. If unspecified the instance name will be used. - - String - - - ConnectionString - - The connection string to use to connect to the queuing system. This is not required for MSMQ. - - String - - - Description - - Set the optional description on the Windows Service. - - String - - - ForwardAuditMessages - - - When enabled the audit forwarding queue retains a copy of the original messages ingested by ServiceControl Audit. Forwarding queues are not directly managed by ServiceControl Audit and are meant as points of external integration. - If external integration is not required, it is highly recommend to turn forwarding off. Otherwise, messages will accumulate unprocessed in the forwarding queue until eventually all available disk space is consumed. - - - SwitchParameter - - - ServiceAccount - - - The Windows Account to run the service under. Defaults to the LocalSystem account if no account is specified. - When specifying Active Directory Group Managed Service Accounts use single quotes so Powershell interprets the dollar sign with the account name as a string literal. - - - String - - - ServiceAccountPassword - - The password for the Service Account. When using LocalSystem, LocalService,, NetworkService or an Active Directory Group Managed Service Account no password should be specified. - - String - - - AuditRetentionPeriod - - - AuditRetention Period controls how long ServiceControl retains messages ingested from the Audit queue in the database. The value must be a TimeSpan within the range 1 hour to 365 days. - Use the New-TimeSpan cmdlet to generate a TimeSpan value. - - - TimeSpan - - - ServiceControlQueueAddress - - - - String - - - SkipQueueCreation - - Normally an instance will attempt to create the queues that it uses. If this flag is set, queue creation will be skipped. - - SwitchParameter - - - Force - - Force the installation even if the directories specified are not empty - - SwitchParameter - - - - - - Name - - The name of the ServiceControl Audit instance. This will be used as the Windows Service Name. The name must be unique for all Windows services and not contain any spaces or special characters. - - String - - String - - - - - - InstallPath - - The directory to use for this ServiceControl Audit Instance. The binary files are copied here. This directory should be empty or not exist and the path should not be a subfolder of the DBPath or LogPath - - String - - String - - - - - - DBPath - - The directory that will contain the embedded database files for this ServiceControl Audit Instance. This should be unique for each instance of ServiceControl and should not be a subfolder of the InstallPath or LogPath. - - String - - String - - - - - - LogPath - - The directory that will contain the logs for this instance of ServiceControl Audit. This should be empty or not exist and should not be a subfolder of the InstallPath. - - String - - String - - - - - - HostName - - - The hostname to use in the URLACL. Values for hostname can be localhost, the fully qualified DNS name fo teh computer or the wildcard character '*' . If localhost is used the URL will only be accessible locally, - WARNING: The default value is localhost. Consider carefully the implications of exposing ServiceControl Audit via a custom or wildcard URL. There is no inbuilt security so all messages stroed will be accessable using anonymous access. - - - String - - String - - - localhost - - - Port - - - The TCP port number to listen on. The port number must be unique for each instance and not be in use by another process. Use the Test-IfPortIsAvailable cmdlet to verify a port number is free. - The allowed port range is 1 to 49151. - - - Int32 - - Int32 - - - - - - DatabaseMaintenancePort - - - - Int32 - - Int32 - - - - - - AuditQueue - - Specifies the input queue name to consume audit messages from. - - String - - String - - - audit - - - AuditLogQueue - - The queue that audit messages will be forwarded to if ForwardAuditMessages is enabled. See ForwardAuditMessages for more information. - - String - - String - - - audit.log - - - Transport - - - The name of the NServiceBus Transport to use. e.g. "AzureServiceBus", "AzureStorageQueue", "MSMQ", "SQLServer" or "RabbitMQ". - Execute 'Get-ServiceControlTransportTypes | Select -Property Name' to retrieve the full list of valid transports. - - - String - - String - - - - - - DisplayName - - Specify the Windows Service Display name. If unspecified the instance name will be used. - - String - - String - - - - - - ConnectionString - - The connection string to use to connect to the queuing system. This is not required for MSMQ. - - String - - String - - - - - - Description - - Set the optional description on the Windows Service. - - String - - String - - - - - - ForwardAuditMessages - - - When enabled the audit forwarding queue retains a copy of the original messages ingested by ServiceControl Audit. Forwarding queues are not directly managed by ServiceControl Audit and are meant as points of external integration. - If external integration is not required, it is highly recommend to turn forwarding off. Otherwise, messages will accumulate unprocessed in the forwarding queue until eventually all available disk space is consumed. - - - SwitchParameter - - SwitchParameter - - - - - - ServiceAccount - - - The Windows Account to run the service under. Defaults to the LocalSystem account if no account is specified. - When specifying Active Directory Group Managed Service Accounts use single quotes so Powershell interprets the dollar sign with the account name as a string literal. - - - String - - String - - - localsystem - - - ServiceAccountPassword - - The password for the Service Account. When using LocalSystem, LocalService,, NetworkService or an Active Directory Group Managed Service Account no password should be specified. - - String - - String - - - - - - AuditRetentionPeriod - - - AuditRetention Period controls how long ServiceControl retains messages ingested from the Audit queue in the database. The value must be a TimeSpan within the range 1 hour to 365 days. - Use the New-TimeSpan cmdlet to generate a TimeSpan value. - - - TimeSpan - - TimeSpan - - - - - - ServiceControlQueueAddress - - - - String - - String - - - - - - SkipQueueCreation - - Normally an instance will attempt to create the queues that it uses. If this flag is set, queue creation will be skipped. - - SwitchParameter - - SwitchParameter - - - - - - Force - - Force the installation even if the directories specified are not empty - - SwitchParameter - - SwitchParameter - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - New-MonitoringInstance - - Add a new instance of ServiceControl Monitoring service. - - - - - New - MonitoringInstance - - - - Add a new instance of ServiceControl Monitoring service. - - - - New-MonitoringInstance - - Name - - The name of the ServiceControl Monitoring instance. This will be used as the Windows Service Name. The name must be unique for all Windows services and not contain any spaces or special characters. - - String - - - InstallPath - - The directory to use for this ServiceControl Monitoring Instance. The binary files are copied here. This directory should be empty or not exist and the path should not be a subfolder of the LogPath - - String - - - LogPath - - The directory that will contain the logs for this instance of ServiceControl Monitoring. This should be empty or not exist and should not be a subfolder of the InstallPath. - - String - - - HostName - - The hostname to use in the URLACL. Values for hostname can be localhost, the fully qualified DNS name fo teh computer or the wildcard character '*'. If localhost is used the URL will only be accessible locally, - - String - - - Port - - - The TCP port number to listen on.. The port number must be unique for each instance and not be in use by another process. Use the Test-IfPortIsAvailable cmdlet to verify a port number is free. - The allowed port range is 1 to 49151. - - - Int32 - - - ErrorQueue - - Specifies the queue name errors messages are written to - - String - - - Transport - - - The name of the NServiceBus Transport to use. e.g. "AzureServiceBus", "AzureStorageQueue", "MSMQ", "SQLServer" or "RabbitMQ". - Execute 'Get-ServiceControlTransportTypes | Select -Property Name' to retrieve the full list of valid transports. - - - String - - - DisplayName - - Specify the Windows Service Display name. If unspecified the instance name will be used. - - String - - - ConnectionString - - The connection string to use to connect to the queuing system. This is not required for MSMQ. - - String - - - Description - - Set the optional description on the Windows Service. - - String - - - ServiceAccount - - - The Windows Account to run the service under. Defaults to the LocalSystem account if no account is specified. - When specifying Active Directory Group Managed Service Accounts use single quotes so Powershell interprets the dollar sign with the account name as a string literal. - - - String - - - ServiceAccountPassword - - The password for the Service Account. When using LocalSystem, LocalService,, NetworkService or an Active Directory Group Managed Service Account no password should be specified. - - String - - - SkipQueueCreation - - Normally an instance will attempt to create the queues that it uses. If this flag is set, queue creation will be skipped. - - SwitchParameter - - - Force - - Force the installation even if the directories specified are not empty - - SwitchParameter - - - - - - Name - - The name of the ServiceControl Monitoring instance. This will be used as the Windows Service Name. The name must be unique for all Windows services and not contain any spaces or special characters. - - String - - String - - - - - - InstallPath - - The directory to use for this ServiceControl Monitoring Instance. The binary files are copied here. This directory should be empty or not exist and the path should not be a subfolder of the LogPath - - String - - String - - - - - - LogPath - - The directory that will contain the logs for this instance of ServiceControl Monitoring. This should be empty or not exist and should not be a subfolder of the InstallPath. - - String - - String - - - - - - HostName - - The hostname to use in the URLACL. Values for hostname can be localhost, the fully qualified DNS name fo teh computer or the wildcard character '*'. If localhost is used the URL will only be accessible locally, - - String - - String - - - - - - Port - - - The TCP port number to listen on.. The port number must be unique for each instance and not be in use by another process. Use the Test-IfPortIsAvailable cmdlet to verify a port number is free. - The allowed port range is 1 to 49151. - - - Int32 - - Int32 - - - - - - ErrorQueue - - Specifies the queue name errors messages are written to - - String - - String - - - - - - Transport - - - The name of the NServiceBus Transport to use. e.g. "AzureServiceBus", "AzureStorageQueue", "MSMQ", "SQLServer" or "RabbitMQ". - Execute 'Get-ServiceControlTransportTypes | Select -Property Name' to retrieve the full list of valid transports. - - - String - - String - - - - - - DisplayName - - Specify the Windows Service Display name. If unspecified the instance name will be used. - - String - - String - - - - - - ConnectionString - - The connection string to use to connect to the queuing system. This is not required for MSMQ. - - String - - String - - - - - - Description - - Set the optional description on the Windows Service. - - String - - String - - - - - - ServiceAccount - - - The Windows Account to run the service under. Defaults to the LocalSystem account if no account is specified. - When specifying Active Directory Group Managed Service Accounts use single quotes so Powershell interprets the dollar sign with the account name as a string literal. - - - String - - String - - - - - - ServiceAccountPassword - - The password for the Service Account. When using LocalSystem, LocalService,, NetworkService or an Active Directory Group Managed Service Account no password should be specified. - - String - - String - - - - - - SkipQueueCreation - - Normally an instance will attempt to create the queues that it uses. If this flag is set, queue creation will be skipped. - - SwitchParameter - - SwitchParameter - - - - - - Force - - Force the installation even if the directories specified are not empty - - SwitchParameter - - SwitchParameter - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - New-ServiceControlInstance - - Add a new instance of ServiceControl service. - - - - - New - ServiceControlInstance - - - - Add a new instance of ServiceControl and registers it as Windows Service. - - - - New-ServiceControlInstance - - Name - - The name of the ServiceControl instance. This will be used as the Windows Service Name. The name must be unique for all Windows services and not contain any spaces or special characters. - - String - - - InstallPath - - The directory to use for this ServiceControl Instance. The binary files are copied here. This directory should be empty or not exist and the path should not be a subfolder of the DBPath or LogPath - - String - - - DBPath - - The directory that will contain the embedded database files for this ServiceControl Instance. This should be unique for each instance of ServiceControl and should not be a subfolder of the InstallPath or LogPath. - - String - - - LogPath - - The directory that will contain the logs for this instance of ServiceControl. This should be empty or not exist and should not be a subfolder of the InstallPath. - - String - - - HostName - - - The hostname to use in the URLACL. Values for hostname can be localhost, the fully qualified DNS name fo teh computer or the wildcard character '*' . If localhost is used the URL will only be accessible locally, - WARNING: The default value is localhost. Consider carefully the implications of exposing ServiceControl via a custom or wildcard URL. There is no inbuilt security so all messages stroed will be accessable using anonymous access. - - - String - - - Port - - - The TCP port number to listen on. If this is the only ServiceControl instance then 33333 is recommended. The port number must be unique for each instance and not be in use by another process. Use the Test-IfPortIsAvailable cmdlet to verify a port number is free. - The allowed port range is 1 to 49151. - - - Int32 - - - DatabaseMaintenancePort - - - - Int32 - - - ErrorQueue - - Specifies the input queue name to consume error messages from. - - String - - - ErrorLogQueue - - The queue that error messages will be forwarded to if ForwardErrorMessages is enabled. See ForwardErrorMessages for more information. - - String - - - Transport - - - The name of the NServiceBus Transport to use. e.g. "AzureServiceBus", "AzureStorageQueue", "MSMQ", "SQLServer" or "RabbitMQ". - Execute 'Get-ServiceControlTransportTypes | Select -Property Name' to retrieve the full list of valid transports. - - - String - - - DisplayName - - Specify the Windows Service Display name. If unspecified the instance name will be used. - - String - - - VirtualDirectory - - - DEPRECATED. - Optional Virtual directory name. Not recommended, this is retained for legacy configuration purposes. - - - String - - - ConnectionString - - The connection string to use to connect to the queuing system. This is not required for MSMQ. - - String - - - Description - - Set the optional description on the Windows Service. - - String - - - ForwardErrorMessages - - - When enabled the error forwarding queue retains a copy of the original messages ingested by ServiceControl. Forwarding queues are not directly managed by ServiceControl and are meant as points of external integration. - If external integration is not required, it is highly recommend to turn forwarding off. Otherwise, messages will accumulate unprocessed in the forwarding queue until eventually all available disk space is consumed. - - - SwitchParameter - - - ServiceAccount - - - The Windows Account to run the service under. Defaults to the LocalSystem account if no account is specified. - When specifying Active Directory Group Managed Service Accounts use single quotes so Powershell interprets the dollar sign with the account name as a string literal. - - - String - - - ServiceAccountPassword - - The password for the Service Account. When using LocalSystem, LocalService,, NetworkService or an Active Directory Group Managed Service Account no password should be specified. - - String - - - ErrorRetentionPeriod - - - ErrorRetentionPeriod controls how long ServiceControl retains messages ingested from the Error queue in the database. - The retention policy does not remove error messages that still in the unresolved state. - The value must be a TimeSpan within the range 5 days to 45 days. Use the New-TimeSpan cmdlet to generate a TimeSpan value. - - - TimeSpan - - - SkipQueueCreation - - Normally an instance will attempt to create the queues that it uses. If this flag is set, queue creation will be skipped. - - SwitchParameter - - - Force - - Force the installation even if the directories specified are not empty - - SwitchParameter - - - - - - Name - - The name of the ServiceControl instance. This will be used as the Windows Service Name. The name must be unique for all Windows services and not contain any spaces or special characters. - - String - - String - - - - - - InstallPath - - The directory to use for this ServiceControl Instance. The binary files are copied here. This directory should be empty or not exist and the path should not be a subfolder of the DBPath or LogPath - - String - - String - - - - - - DBPath - - The directory that will contain the embedded database files for this ServiceControl Instance. This should be unique for each instance of ServiceControl and should not be a subfolder of the InstallPath or LogPath. - - String - - String - - - - - - LogPath - - The directory that will contain the logs for this instance of ServiceControl. This should be empty or not exist and should not be a subfolder of the InstallPath. - - String - - String - - - - - - HostName - - - The hostname to use in the URLACL. Values for hostname can be localhost, the fully qualified DNS name fo teh computer or the wildcard character '*' . If localhost is used the URL will only be accessible locally, - WARNING: The default value is localhost. Consider carefully the implications of exposing ServiceControl via a custom or wildcard URL. There is no inbuilt security so all messages stroed will be accessable using anonymous access. - - - String - - String - - - localhost - - - Port - - - The TCP port number to listen on. If this is the only ServiceControl instance then 33333 is recommended. The port number must be unique for each instance and not be in use by another process. Use the Test-IfPortIsAvailable cmdlet to verify a port number is free. - The allowed port range is 1 to 49151. - - - Int32 - - Int32 - - - - - - DatabaseMaintenancePort - - - - Int32 - - Int32 - - - - - - ErrorQueue - - Specifies the input queue name to consume error messages from. - - String - - String - - - error - - - ErrorLogQueue - - The queue that error messages will be forwarded to if ForwardErrorMessages is enabled. See ForwardErrorMessages for more information. - - String - - String - - - errorlog - - - Transport - - - The name of the NServiceBus Transport to use. e.g. "AzureServiceBus", "AzureStorageQueue", "MSMQ", "SQLServer" or "RabbitMQ". - Execute 'Get-ServiceControlTransportTypes | Select -Property Name' to retrieve the full list of valid transports. - - - String - - String - - - - - - DisplayName - - Specify the Windows Service Display name. If unspecified the instance name will be used. - - String - - String - - - - - - VirtualDirectory - - - DEPRECATED. - Optional Virtual directory name. Not recommended, this is retained for legacy configuration purposes. - - - String - - String - - - - - - ConnectionString - - The connection string to use to connect to the queuing system. This is not required for MSMQ. - - String - - String - - - - - - Description - - Set the optional description on the Windows Service. - - String - - String - - - - - - ForwardErrorMessages - - - When enabled the error forwarding queue retains a copy of the original messages ingested by ServiceControl. Forwarding queues are not directly managed by ServiceControl and are meant as points of external integration. - If external integration is not required, it is highly recommend to turn forwarding off. Otherwise, messages will accumulate unprocessed in the forwarding queue until eventually all available disk space is consumed. - - - SwitchParameter - - SwitchParameter - - - - - - ServiceAccount - - - The Windows Account to run the service under. Defaults to the LocalSystem account if no account is specified. - When specifying Active Directory Group Managed Service Accounts use single quotes so Powershell interprets the dollar sign with the account name as a string literal. - - - String - - String - - - localsystem - - - ServiceAccountPassword - - The password for the Service Account. When using LocalSystem, LocalService,, NetworkService or an Active Directory Group Managed Service Account no password should be specified. - - String - - String - - - - - - ErrorRetentionPeriod - - - ErrorRetentionPeriod controls how long ServiceControl retains messages ingested from the Error queue in the database. - The retention policy does not remove error messages that still in the unresolved state. - The value must be a TimeSpan within the range 5 days to 45 days. Use the New-TimeSpan cmdlet to generate a TimeSpan value. - - - TimeSpan - - TimeSpan - - - - - - SkipQueueCreation - - Normally an instance will attempt to create the queues that it uses. If this flag is set, queue creation will be skipped. - - SwitchParameter - - SwitchParameter - - - - - - Force - - Force the installation even if the directories specified are not empty - - SwitchParameter - - SwitchParameter - - - - - - AuditRetentionPeriod - - - AuditRetention Period controls how long ServiceControl retains messages ingested from the Audit queue in the database. The value must be a TimeSpan within the range 1 hour to 365 days. - Use the New-TimeSpan cmdlet to generate a TimeSpan value. - - - timespan - - timespan - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -------------------------- Example 1 -------------------------- - - PS C:\> - - - $AuditRetention = New-TimeSpan -Days 30 - $ErrorRetention = New-TimeSpan -Days 30 - - New-ServiceControlInstance -Name 'ServiceControlTest' ` - -InstallPath 'c:\bin\ServiceControlProd' ` - -DBPath 'c:\data\ServiceControlProd\DB' ` - -LogPath 'c:\data\ServiceControlProd\Logs' ` - -HostName 'localhost' ` - -Port 33333 ` - -ErrorQueue error ` - -Transport MSMQ ` - -DisplayName 'ServiceControl Test' ` - -AuditRetentionPeriod $AuditRetention ` - -ErrorRetentionPeriod $ErrorRetention ` - -ForwardErrorMessages:$false - - - Add a servicecontrol instance - - - - WARNING: ServiceAccountset to default value 'LocalSystem' - VERBOSE: Installing Service Control instance... - - - Name : ServiceControlTest - Url : http://localhost:33335/api/ - HostName : localhost - Port : 33331 - InstallPath : c:\bin\ServiceControlProd - DBPath : c:\data\ServiceControlProd\DB - LogPath : c:\data\ServiceControlProd\Logs - TransportPackage : MSMQ - ConnectionString : - ErrorQueue : error - ErrorLogQueue : error.log - ForwardErrorMessages : False - ServiceAccount : LocalSystem - Version : 1.33.0 - - - - - - - - - - - - - - - - - - Remove-AuditInstance - - Removes a instance of ServiceControl Audit service. - - - - - Remove - AuditInstance - - - - Removes an instance of ServiceControl Audit service for the list of running services and deletes the bin folder. The logs and RavenDB folders can also be removed - - - - Remove-AuditInstance - - Name - - Name of the ServiceControl Audit Service to remove. This corresponds to the Windows Service Name for the service not the Display Name. - - String[] - - - RemoveDB - - Remove the contents of the Database folder. - - SwitchParameter - - - RemoveLogs - - Remove the contents of the Log folder. - - SwitchParameter - - - - - - Name - - Name of the ServiceControl Audit Service to remove. This corresponds to the Windows Service Name for the service not the Display Name. - - String[] - - String[] - - - - - - RemoveDB - - Remove the contents of the Database folder. - - SwitchParameter - - SwitchParameter - - - - - - RemoveLogs - - Remove the contents of the Log folder. - - SwitchParameter - - SwitchParameter - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Remove-MonitoringInstance - - Removes a instance of ServiceControl Monitoring service. - - - - - Remove - MonitoringInstance - - - - Removes an instance of ServiceControl Monitoring service for the list of running services and deletes the bin folder. The logs folder can also be removed - - - - Remove-MonitoringInstance - - Name - - Name of the ServiceControl Monitoting service to remove. This corresponds to the Windows Service Name for the service not the Display Name. - - String[] - - - RemoveLogs - - Remove the contents of the Log folder as part of the instance removal - - SwitchParameter - - - - - - Name - - Name of the ServiceControl Monitoting service to remove. This corresponds to the Windows Service Name for the service not the Display Name. - - String[] - - String[] - - - - - - RemoveLogs - - Remove the contents of the Log folder as part of the instance removal - - SwitchParameter - - SwitchParameter - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Remove-ServiceControlInstance - - Removes a instance of ServiceControl service. - - - - - Remove - ServiceControlInstance - - - - Removes an instance of ServiceControl service for the list of running services and deletes the bin folder. The logs and RavenDB folders can also be removed - - - - Remove-ServiceControlInstance - - Name - - Name of the ServiceControl Service to remove. This corresponds to the Windows Service Name for the service not the Display Name. - - String[] - - - RemoveDB - - Remove the contents of the Database folder. - - SwitchParameter - - - RemoveLogs - - Remove the contents of the Log folder. - - SwitchParameter - - - - - - Name - - Name of the ServiceControl Service to remove. This corresponds to the Windows Service Name for the service not the Display Name. - - String[] - - String[] - - - - - - RemoveDB - - Remove the contents of the Database folder. - - SwitchParameter - - SwitchParameter - - - False - - - RemoveLogs - - Remove the contents of the Log folder. - - SwitchParameter - - SwitchParameter - - - False - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Remove-UrlAcl - - Removes a URLACL. - - - - - Remove - UrlAcl - - - - Removes a URLACL Registration form the list of URLACLs. - - - - Remove-UrlAcl - - UrlAcl - - The URLACL to remove. The current URLACLs can be obtained from Get-URLACLs. - - UrlReservation[] - - - - - - UrlAcl - - The URLACL to remove. The current URLACLs can be obtained from Get-URLACLs. - - UrlReservation[] - - UrlReservation[] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -------------------------- Example 1 -------------------------- - - PS C:\> - - - # Remove all URLACLs assigned to port 33333 - Get-UrlAcls | ? Port -EQ 33333 | Remove-UrlACl - - - - - - - - - - - - - - - - - - - https://msdn.microsoft.com/en-us/library/windows/desktop/cc307236%28v=vs.85%29.aspx - - - - - - - - Test-IfPortIsAvailable - - Check a TCP port number to see if it is already in by a running process. - - - - - Test - IfPortIsAvailable - - - - Check a TCP port number to see if it is already in use by a running process. - - - - Test-IfPortIsAvailable - - Port - - The port number to check. Must be between 1 and 65535. - - Int32[] - - - - - - Port - - The port number to check. Must be between 1 and 65535. - - Int32[] - - Int32[] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -------------------------- Example 1 -------------------------- - - PS C:\> - - Test-IfPortIsAvailable -Port 33333 - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/src/ServiceControlInstaller.PowerShell/ServiceControlMgmt.format.ps1xml b/src/ServiceControlInstaller.PowerShell/ServiceControlMgmt.format.ps1xml deleted file mode 100644 index 345d43b6ee..0000000000 --- a/src/ServiceControlInstaller.PowerShell/ServiceControlMgmt.format.ps1xml +++ /dev/null @@ -1,31 +0,0 @@ - - - - - TransportsList - - ServiceControl.Management.PowerShell.PsTransportInfo - - - - - - - - Name - - - - TypeName - - - - SampleConnectionString - - - - - - - - diff --git a/src/ServiceControlInstaller.PowerShell/ServiceControlMgmt.psd1 b/src/ServiceControlInstaller.PowerShell/ServiceControlMgmt.psd1 deleted file mode 100644 index 45926d46ab..0000000000 --- a/src/ServiceControlInstaller.PowerShell/ServiceControlMgmt.psd1 +++ /dev/null @@ -1,17 +0,0 @@ -@{ - GUID = 'ABFF92C4-A8BA-CAAA-A40D-8C97F3B28934' - Author = 'Particular Software' - Description = 'ServiceControl Management' - ModuleVersion = '{{Version}}' - CLRVersion = '4.0' - DotNetFrameworkVersion = '4.0' - NestedModules = @('ServiceControlInstaller.PowerShell.DLL', 'ServiceControlMgmt.psm1') - CompanyName = 'Particular Software' - Copyright = 'Particular Software, Copyright © 2015' - FunctionsToExport='*' - CmdletsToExport = '*' - VariablesToExport = '*' - AliasesToExport = '*' - FormatsToProcess = @("ServiceControlMgmt.format.ps1xml") - RequiredAssemblies = @('ServiceControlInstaller.Engine.DLL') -} \ No newline at end of file diff --git a/src/ServiceControlInstaller.PowerShell/ServiceControlMgmt.psm1 b/src/ServiceControlInstaller.PowerShell/ServiceControlMgmt.psm1 deleted file mode 100644 index 81f9562434..0000000000 --- a/src/ServiceControlInstaller.PowerShell/ServiceControlMgmt.psm1 +++ /dev/null @@ -1,50 +0,0 @@ -<# - .Synopsis - Lists the commands and aliases provided by the ServiceControlMgmt Module. - - .Description - Lists the commands and aliases provided by the ServiceControlMgmt Module. This command is ment - as a starting point as it list what is available in the module. -#> -Function Get-ServiceControlMgmtCommands { - PROCESS { - Get-Alias -Scope Global | ? ModuleName -EQ "ServiceControlMgmt" | Select-Object -Property @{Name = 'Alias'; Expression = {$_.Name}}, @{Name = 'Command'; Expression = {$_.Definition}} - } -} - -<# Init Code #> -$requiredDLL = [AppDomain]::CurrentDomain.GetAssemblies() | Select -ExpandProperty Modules | ? Name -eq ServiceControlInstaller.Engine.dll -if (!$requiredDLL) { - throw "This module was imported incorrectly - use 'Import-Module .\ServiceControlMgmt.psd1' to load this module" -} - -New-Alias -Value Get-ServiceControlInstances -Name sc-instances -New-Alias -Value Invoke-ServiceControlInstanceUpgrade -Name sc-upgrade -New-Alias -Value Remove-ServiceControlInstance -Name sc-delete -New-Alias -Value New-ServiceControlInstance -Name sc-add -New-Alias -Value Get-MonitoringInstances -Name mon-instances -New-Alias -Value Invoke-MonitoringInstanceUpgrade -Name mon-upgrade -New-Alias -Value Remove-MonitoringInstance -Name mon-delete -New-Alias -Value New-MonitoringInstance -Name mon-add -New-Alias -Value Get-ServiceControlAuditInstances -Name audit-instances -New-Alias -Value Invoke-ServiceControlAuditInstanceUpgrade -Name audit-upgrade -New-Alias -Value Remove-ServiceControlAuditInstance -Name audit-delete -New-Alias -Value New-ServiceControlAuditInstance -Name audit-add -New-Alias -Value Get-ServiceControlLicense -Name sc-findlicense -New-Alias -Value Import-ServiceControlLicense -Name sc-addlicense -New-Alias -Value Test-IfPortIsAvailable -Name port-check -New-Alias -Value Get-SecurityIdentifier -Name user-sid -New-Alias -Value Get-UrlAcls -Name urlacl-list -New-Alias -Value Add-UrlAcl -Name urlacl-add -New-Alias -Value Remove-UrlAcl -Name urlacl-delete -New-Alias -Value Get-ServiceControlTransportTypes -Name sc-transportsinfo -New-Alias -Value Get-ServiceControlMgmtCommands -Name sc-help -New-Alias -Value Get-ServiceControlRemotes -Name sc-remotes -New-Alias -Value Add-ServiceControlRemote -Name sc-addremote -New-Alias -Value Remove-ServiceControlRemote -Name sc-deleteremote - -Export-ModuleMember * -Alias * - -Write-Warning "The 'Particular.ServiceControl.Management' module is now distributed on the PowerShell Gallery and should be used instead. This legacy 'ServiceControlMgmt' module will no longer be included in the ServiceControl installer in a future release." - -Write-Verbose "Use SC-help to list ServiceControl Management commands" -Verbose diff --git a/src/ServiceControlInstaller.PowerShell/ShortcutStartup.ps1 b/src/ServiceControlInstaller.PowerShell/ShortcutStartup.ps1 deleted file mode 100644 index ff7845a925..0000000000 --- a/src/ServiceControlInstaller.PowerShell/ShortcutStartup.ps1 +++ /dev/null @@ -1,16 +0,0 @@ -if ($PSScriptRoot) { - if ($PSVersionTable.PSVersion.Major -LT 3 ) { - Write-Warning "ServiceControl Management Module not loaded - PowerShell 3.0 or greater required" - } - else - { - Set-ExecutionPolicy -Scope Process Undefined -Force - if ($(Get-ExecutionPolicy) -eq "Restricted") { - Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned -Force - } - Import-Module (Join-Path $PSScriptRoot ServiceControlMgmt.psd1) - SC-Help - } -} else { - Write-Warning "ServiceControl Management Module not loaded - PowerShell 3.0 or greater required" -} diff --git a/src/Setup/ServiceControl.aip b/src/Setup/ServiceControl.aip index 472ae735b0..cddc5b0948 100644 --- a/src/Setup/ServiceControl.aip +++ b/src/Setup/ServiceControl.aip @@ -1,14 +1,13 @@ - + + - - @@ -26,7 +25,7 @@ - + @@ -47,22 +46,10 @@ - - - - - - - - - - - - @@ -74,85 +61,47 @@ - - - - - - - - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - @@ -172,22 +121,11 @@ - - - - - - - - - - - @@ -219,42 +157,12 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + - @@ -264,6 +172,11 @@ + + + + + @@ -296,8 +209,12 @@ + + + + @@ -378,16 +295,20 @@ + + + + - + @@ -396,23 +317,29 @@ + + - + + + + + @@ -444,20 +371,12 @@ - - - - - - - - @@ -487,36 +406,6 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -563,6 +452,8 @@ + + @@ -612,7 +503,6 @@ - @@ -626,10 +516,10 @@ - - - - + + + + @@ -640,7 +530,6 @@ - diff --git a/src/Setup/Setup.csproj b/src/Setup/Setup.csproj index 725caf2118..4e0d590b31 100644 --- a/src/Setup/Setup.csproj +++ b/src/Setup/Setup.csproj @@ -48,7 +48,6 @@ - From adbe8207beff5242ac74c050897746bba20e5ec1 Mon Sep 17 00:00:00 2001 From: David Boike Date: Fri, 13 Oct 2023 17:10:46 -0500 Subject: [PATCH 2/2] Edits with correct version of Advanced Installer --- src/Setup/ServiceControl.aip | 39 +++++++++--------------------------- 1 file changed, 9 insertions(+), 30 deletions(-) diff --git a/src/Setup/ServiceControl.aip b/src/Setup/ServiceControl.aip index cddc5b0948..eb74e61a4a 100644 --- a/src/Setup/ServiceControl.aip +++ b/src/Setup/ServiceControl.aip @@ -1,13 +1,14 @@ - + - + + @@ -25,7 +26,7 @@ - + @@ -172,11 +173,6 @@ - - - - - @@ -209,12 +205,8 @@ - - - - @@ -295,10 +287,6 @@ - - - - @@ -308,7 +296,6 @@ - @@ -317,29 +304,23 @@ - - - - + - - - @@ -452,8 +433,6 @@ - - @@ -516,10 +495,10 @@ - - - - + + + +