2021-09-14 09:41:44 -06:00
# Get-SystemStatus
2021-09-14 14:12:03 -06:00
Gathers the follow information from a provided list of computers.
The collected data is then returned as a DataTable or can be exported to a variety of file formats.
Optional Metadata can be included to be included in the returned results/reports to assist in machine identification.
2021-09-14 09:41:44 -06:00
2021-09-14 14:12:03 -06:00
Collected Data: Computer Name, Operating System, Operating System Build, Uptime, Recent Updates, Disk Space Utilization, Date Gathered
Optional Metadata: Organization, Role, UpdateWindow
2021-09-14 09:41:44 -06:00
## Variables
2021-09-14 14:12:03 -06:00
### ComputerName Set
| Variable | Required | Default | Choices | Description |
| -------------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------- |
| ComputerName | Yes | | | Specifies a computer or set of computers that should be queried for their status |
### CsvPath Set
| Variable | Required | Default | Choices | Description |
| -------------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------- |
| CsvPath | Yes | | | Specifies a computer or set of computers that should be queried for their status |
### Credential Set
| Variable | Required | Default | Choices | Description |
| ---------- | -------- | ------- | ------- | ----------------------------------------------------------------------------------------------------- |
| Credential | Yes | | | Credentials used for connecting to the specified computers to gather the machine's status information |
### CredentialPath Set
| Variable | Required | Default | Choices | Description |
| -------------- | -------- | ------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
| CredentialPath | Yes | | | Path to stored credentials that will be imported using Import-Clixml to allow for storing credentials using a secure method |
### Report Set
| Variable | Required | Default | Choices | Description |
| -------------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------- |
| OutputType | No | JSON | CSV, JSON, HTML | Style of report that should be output |
| OutputPath | Yes | | | Path to where the report should be saved |
### Common Variables
| Variable | Required | Default | Choices | Description |
| -------------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------- |
| Organization | No | | | Optional metadata that can be included in the returned results |
| Role | No | | | Optional metadata that can be included in the returned results |
| UpdateWindow | No | | | Optional metadata that can be included in the returned results |
## Syntax
```powershell
Get-SystemStatus.ps1 [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 -ComputerName < String [ ] > -CredentialPath < String > [-OutputType < String > ] -OutputPath < String > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 -ComputerName < String [ ] > -CredentialPath < String > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 -ComputerName < String [ ] > -Credential < PSCredential > [-OutputType < String > ] -OutputPath < String > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 -ComputerName < String [ ] > -Credential < PSCredential > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 -ComputerName < String [ ] > [-OutputType < String > ] -OutputPath < String > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 -ComputerName < String [ ] > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 -CsvPath < String > -CredentialPath < String > [-OutputType < String > ] -OutputPath < String > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 -CsvPath < String > -CredentialPath < String > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 -CsvPath < String > -Credential < PSCredential > [-OutputType < String > ] -OutputPath < String > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 -CsvPath < String > -Credential < PSCredential > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 -CsvPath < String > [-OutputType < String > ] -OutputPath < String > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 -CsvPath < String > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
```powershell
Get-SystemStatus.ps1 [-OutputType < String > ] -OutputPath < String > [-Organization < String > ] [-Role < String > ] [-UpdateWindow < String > ] [< CommonParameters > ]
```
2021-09-14 09:41:44 -06:00
## Example
## License
See LICENSE file for full license information.
## Screenshots
2021-09-14 14:12:03 -06:00
![Example Default Execution ](Images/Example-Default.png?raw=true )
![Example Default Execution ](Images/Example-HTML.png?raw=true )