{"id":20156267,"url":"https://github.com/dsccommunity/xscom","last_synced_at":"2025-04-09T22:23:39.938Z","repository":{"id":30468265,"uuid":"34022251","full_name":"dsccommunity/xSCOM","owner":"dsccommunity","description":null,"archived":false,"fork":false,"pushed_at":"2018-09-22T11:32:08.000Z","size":73,"stargazers_count":17,"open_issues_count":6,"forks_count":15,"subscribers_count":25,"default_branch":"dev","last_synced_at":"2025-03-24T00:16:52.154Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dsccommunity.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-04-15T22:43:06.000Z","updated_at":"2024-09-01T23:10:36.000Z","dependencies_parsed_at":"2022-08-22T23:40:32.598Z","dependency_job_id":null,"html_url":"https://github.com/dsccommunity/xSCOM","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxSCOM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxSCOM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxSCOM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxSCOM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dsccommunity","download_url":"https://codeload.github.com/dsccommunity/xSCOM/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248120949,"owners_count":21051056,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T23:38:13.724Z","updated_at":"2025-04-09T22:23:39.918Z","avatar_url":"https://github.com/dsccommunity.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build status](https://ci.appveyor.com/api/projects/status/3rh4o5270qrh4gk3/branch/master?svg=true)](https://ci.appveyor.com/project/PowerShell/xscom/branch/master)\r\n\r\n# xSCOM\r\n\r\nThe **xSCOM** module contains set of DSC resources for installation of System Center Operations Manager (OM).\r\n\r\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\r\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\r\n\r\n## Contributing\r\nPlease check out common DSC Resources [contributing guidelines](https://github.com/PowerShell/DscResource.Kit/blob/master/CONTRIBUTING.md).\r\n\r\n\r\n## Resources\r\n\r\n* **xSCOMManagementServerSetup** installs the OM Management server\r\n* **xSCOMReportingServerSetup** installs the OM Reporting server\r\n* **xSCOMWebConsoleServerSetup** installs the OM Web Console server\r\n* **xSCOMConsoleSetup** installs the OM console\r\n* **xSCOMManagementServerUpdate** updates an OM Management server to Update Rollup 4\r\n* **xSCOMWebConsoleServerUpdate** updates an OM Web Console server to Update Rollup 4\r\n* **xSCOMConsoleUpdate** updates an OM Console to Update Rollup 4\r\n* **xSCOMAdmin** adds OM admins\r\n* **xSCOMManagementPack** installs OM Management Packs\r\n\r\n### xSCOMManagementServerSetup\r\n\r\n* **Ensure**: (Key) Ensures that the OM management server is **Present** or **Absent**.\r\n* **SourcePath**: (Required) UNC path to the root of the source files for installation.\r\n* **SourceFolder**: Folder within the source path containing the source files for installation.\r\n* **SetupCredential**: (Required) Credential to be used to perform the installation.\r\n* **ProductKey**: Product key for licensed installations.\r\n* **InstallPath**: Installation path for the software.\r\n* **ManagementGroupName**: (Required) The name of the management group.\r\n* **FirstManagementServer**: (Required) A boolean indicating if this is the first Management Server.\r\n* **ManagementServicePort**: The Management Server port on install.\r\n* **ActionAccount**: The domain and user name of the Management server action account.\r\n* **ActionAccountUsername**: Output user name of the Management server action account.\r\n* **DASAccount**: The domain and user name of the Data Access service account.\r\n* **DASAccountUsername**: Output user name of the Data Access service account.\r\n* **DataReader**: (Required) The domain and user name of the data reader account.\r\n* **DataReaderUsername**: Output user name of the data reader account.\r\n* **DataWriter**: (Required) The domain and user name of the data writer account.\r\n* **DataWriterUsername**: Output user name of the data writer account.\r\n* **SqlServerInstance**: (Required) The SQL server and instance.\r\n* **DatabaseName**: The name of the Operational database\r\n* **DatabaseSize**: The size in MB of the Operational database.\r\n* **DwSqlServerInstance**: (Required) The data warehouse server and instance.\r\n* **DwDatabaseName**: The name of the data warehouse database.\r\n* **DwDatabaseSize**: The size in MB of the data warehouse database.\r\n* **UseMicrosoftUpdate**: { 0 | 1 }\r\n0: Do not opt in to Microsoft Update.\r\n1: Opt in to Microsoft Update.\r\n* **SendCEIPReports**: { 0 | 1 }\r\n0: Do not opt in to the Customer Experience Improvement Program (CEIP).\r\n1: Opt in to CEIP.\r\n* **EnableErrorReporting**: { Never | Queued | Always }\r\nNever: Do not opt in to sending automatic error reports.\r\nQueued: Opt in to sending error reports, but queue the reports for review before sending.\r\nAlways: Opt in to automatically send error reports.\r\n* **SendODRReports**: { 0 | 1 }\r\n0: Do not opt in to sending operational data reports.\r\n1: Opt in to sending operational data reports.\r\n\r\n### xSCOMReportingServerSetup\r\n\r\n* **Ensure**: (Key) Ensures that the OM reporting server is **Present** or **Absent**.\r\n* **SourcePath**: (Required) UNC path to the root of the source files for installation.\r\n* **SourceFolder**: Folder within the source path containing the source files for installation.\r\n* **SetupCredential**: (Required) Credential to be used to perform the installation.\r\n* **InstallPath**: Installation path for the software.\r\n* **ManagementServer**: (Required) The name of the management server associated with the reporting server.\r\n* **SRSInstance**: (Required) The reporting server and instance.\r\n* **DataReader**: (Required) The domain and user name of the data reader account.\r\n* **DataReaderUsername**: Output user name of the data reader account.\r\n* **UseMicrosoftUpdate**: { 0 | 1 }\r\n0: Do not opt in to Microsoft Update.\r\n1: Opt in to Microsoft Update.\r\n* **SendCEIPReports**: { 0 | 1 }\r\n0: Do not opt in to the Customer Experience Improvement Program (CEIP).\r\n1: Opt in to CEIP.\r\n* **EnableErrorReporting**: { Never | Queued | Always }\r\nNever: Do not opt in to sending automatic error reports.\r\nQueued: Opt in to sending error reports, but queue the reports for review before sending.\r\nAlways: Opt in to automatically send error reports.\r\n* **SendODRReports**: { 0 | 1 }\r\n0: Do not opt in to sending operational data reports.\r\n1: Opt in to sending operational data reports.\r\n\r\n### xSCOMWebConsoleServerSetup\r\n\r\n* **Ensure**: (Key) Ensures that the OM web console server is **Present** or **Absent**.\r\n* **SourcePath**: (Required) UNC path to the root of the source files for installation.\r\n* **SourceFolder**: Folder within the source path containing the source files for installation.\r\n* **SetupCredential**: (Required) Credential to be used to perform the installation.\r\n* **InstallPath**: Installation path for the software.\r\n* **ManagementServer**: (Required) The name of the management server associated with the Reporting server.\r\n* **WebSiteName**: The name of the website.\r\n* **WebConsoleAuthorizationMode**:{ Mixed | Network }\r\nMixed: Used for intranet scenarios.\r\nNetwork: Used for extranet scenarios.\r\n* **WebConsoleUseSSL**: Specify only if your website has Secure Sockets Layer (SSL) activated.\r\n* **UseMicrosoftUpdate**: { 0 | 1 }\r\n0: Do not opt in to Microsoft Update.\r\n1: Opt in to Microsoft Update.\r\n* **SendCEIPReports**: { 0 | 1 }\r\n0: Do not opt in to the Customer Experience Improvement Program (CEIP).\r\n1: Opt in to CEIP.\r\n* **EnableErrorReporting**: { Never | Queued | Always }\r\nNever: Do not opt in to sending automatic error reports.\r\nQueued: Opt in to sending error reports, but queue the reports for review before sending.\r\nAlways: Opt in to automatically send error reports.\r\n* **SendODRReports**: { 0 | 1 }\r\n0: Do not opt in to sending operational data reports.\r\n1: Opt in to sending operational data reports.\r\n\r\n### xSCOMConsoleSetup\r\n\r\n* **Ensure**: (Key) Ensures that the OM console is **Present** or **Absent**.\r\n* **SourcePath**: (Required) UNC path to the root of the source files for installation.\r\n* **SourceFolder**: Folder within the source path containing the source files for installation.\r\n* **SetupCredential**: (Required) Credential to be used to perform the installation.\r\n* **InstallPath**: Installation path for the software.\r\n* **UseMicrosoftUpdate**: { 0 | 1 }\r\n0: Do not opt in to Microsoft Update.\r\n1: Opt in to Microsoft Update.\r\n* **SendCEIPReports**: { 0 | 1 }\r\n0: Do not opt in to the Customer Experience Improvement Program (CEIP).\r\n1: Opt in to CEIP.\r\n* **EnableErrorReporting**: { Never | Queued | Always }\r\nNever: Do not opt in to sending automatic error reports.\r\nQueued: Opt in to sending error reports, but queue the reports for review before sending.\r\nAlways: Opt in to automatically send error reports.\r\n* **SendODRReports**: { 0 | 1 }\r\n0: Do not opt in to sending operational data reports.\r\n1: Opt in to sending operational data reports.\r\n\r\n### xSCOMManagementServerUpdate\r\n\r\n* **Ensure**: (Key) Ensures that the OM management server update is **Present** or **Absent**.\r\n* **SourcePath**: (Required) UNC path to the root of the source files for installation.\r\n* **SourceFolder**: Folder within the source path containing the source files for installation.\r\n* **Credential**: (Required) Credential to be used to perform the installation.\r\n* **Update**: Output display name of the update.\r\n\r\n### xSCOMWebConsoleServerUpdate\r\n\r\n* **Ensure**: (Key) Ensures that the OM web console server update is **Present** or **Absent**.\r\n* **SourcePath**: (Required) UNC path to the root of the source files for installation.\r\n* **SourceFolder**: Folder within the source path containing the source files for installation.\r\n* **Credential**: (Required) Credential to be used to perform the installation.\r\n* **Update**: Output display name of the update.\r\n\r\n### xSCOMConsoleUpdate\r\n\r\n* **Ensure**: (Key) Ensures that the OM console update is **Present** or **Absent**.\r\n* **SourcePath**: (Required) UNC path to the root of the source files for installation.\r\n* **SourceFolder**: Folder within the source path containing the source files for installation.\r\n* **Credential**: (Required) Credential to be used to perform the installation.\r\n* **Update**: Output display name of the update.\r\n\r\n### xSCOMAdmin\r\n\r\n* **Ensure**: An enumerated value that describes if the principal is an Operations Manager admin.\r\n* **Principal**: (Key) The Operations Manager admin principal.\r\n* **UserRole**: (Key) The Operations Manager user role.\r\n* **SCOMAdminCredential**: (Required) Credential to be used to perform the operations.\r\n\r\n**xSCOMManagementPack** has the following properties:\r\n\r\n* **Name**: (Key) Name of the Management Pack.\r\n* **Version**: Specific version of the Management Pack.\r\nNote: This overrides MinVersion if both are set.\r\n* **MinVersion**: Minimum version of the Management Pack.\r\nNote: This is overridden by Version if both are set.\r\n* **SCOMAdminCredential**: (Required) Credential with admin permissions to Operations Manager.\r\n* **SourcePath**: (Required) UNC path to the root of the source files for installation.\r\n* **SourceFolder**: Folder within the source path containing the source files for installation.\r\n* **SourceFile**: Name of the file in the source folder for the Management Pack.\r\n\r\n## Versions\r\n\r\n### Unreleased\r\n\r\n* Update appveyor.yml to use the default template.\r\n* Added default template files .codecov.yml, .gitattributes, and .gitignore, and\r\n  .vscode folder.\r\n\r\n### 1.3.3.0\r\n\r\n* Increased timeout for setup process to start to 60 seconds.\r\n* Modified MSFT_xSCOMConsoleUpdate, MSFT_xSCOMManagementServerUpdate, and MSFT_xSCOMWebConsoleServerUpdate resources to use /norestart, allowing DSC to control reboots.\r\n\r\n### 1.2.0.0\r\n\r\n* Updated to include the following resources:\r\n    - xSCOMManagementServerUpdate\r\n    - xSCOMWebConsoleServerUpdate\r\n    - xSCOMConsoleUpdate\r\n    - xSCOMAdmin\r\n    - xSCOMManagementPack\r\n\r\n### 1.1.0.0\r\n\r\n* Initial release with the following resources:\r\n    - xSCOMManagementServerSetup\r\n    - xSCOMConsoleSetup\r\n    - xSCOMReportingServerSetup,\r\n    - xSCOMWebConsoleServerSetup\r\n\r\n## Examples\r\n\r\nFour example configurations are included in the Examples folder within the module.\r\nAll four examples also use the **xCredSSP** and **xSQLServer** modules.\r\nNote: the samples require the use of [Windows Management Framework (WMF) 5.0 Preview](http://go.microsoft.com/fwlink/?LinkId=398175).\r\n\r\nNote: In the Examples folder you will see a version of each file with \"-TP\" appended to the name.\r\nThese are the equivalent examples for deployment of System Center Technical Preview on Windows Server Technical Preview.\r\n\r\n### Single Server Installation\r\n\r\nSCOM-SingleServer.ps1 installs all OM roles including prerequisites and SQL on a single server.\r\n\r\n### Separate SQL\r\n\r\nSCOM-SeperateSQL.ps1 installs all OM roles on one server and SQL on a separate server.\r\n\r\n### Multiple Separate SQL Instances\r\n\r\nSCOM-SeperateSQLInstances.ps1 installs all OM roles on one server and SQL in multiple instances on a separate server.\r\n\r\n### Multiple Management Servers\r\n\r\nSCOM-MultiInstance.ps1 installs all OM roles including multiple management servers each on their own server with multiple SQL Servers.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsccommunity%2Fxscom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdsccommunity%2Fxscom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsccommunity%2Fxscom/lists"}