Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mkht/audiovolumedsc
https://github.com/mkht/audiovolumedsc
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/mkht/audiovolumedsc
- Owner: mkht
- License: mit
- Created: 2020-12-08T16:32:43.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-08-20T14:55:24.000Z (over 2 years ago)
- Last Synced: 2024-08-09T11:43:50.346Z (5 months ago)
- Language: PowerShell
- Size: 77.1 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
AudioVolumeDsc
====PowerShell DSC Resource to control audio volume.
## Install
You can install Resource through [PowerShell Gallery](https://www.powershellgallery.com/packages/AudioVolumeDsc/).
```PowerShell
Install-Module -Name AudioVolumeDsc
```## Resources
* **AudioVolume**
PowerShell DSC Resource to control audio volume.## Properties
### AudioVolume
+ [string] **DeviceName** (Key):
+ The name of the audio device.
+ You can use regular expression.
+ If more than one devices found, all devices are targeted for configuration.+ [int] **Volume** (Required):
+ The target volume. (0 to 100)+ [bool] **Mute** (Write):
+ The state of mute.
+ Default is `$false`+ [bool] **SkipWhenDeviceNotPresent** (Write):
+ When this property is specied as `$true`, this resouce won't throw an error if the device is not found.
+ Default is `$false`## Examples
+ **Example 1**: Set the volume of the "Speaker" to 80.
```PowerShell
Configuration Example1
{
Import-DscResource -ModuleName AudioVolumeDsc
AudioVolume Speaker80
{
DeviceName = 'Speaker'
Volume = 80
Mute = $false
}
}
```## License
> Copyright (c) 2020 mkht
> AudioVolumeDsc is released under the MIT License
> https://github.com/mkht/AudioVolumeDsc/blob/master/LICENSE
>
> AudioVolumeDsc includes these software / libraries.
> * [CoreAudio](https://github.com/morphx666/CoreAudio)
> Copyright (c) 2017 Xavier Flix
> Licensed under the [MIT License](https://github.com/morphx666/CoreAudio/blob/master/LICENSE).## ChangeLog
### v2.0.0
- if multiple devices with the same name are found, all devices are targeted for configuration.
- Devices in an inactive state are also targeted for configuration.
- Update [CoreAudio.dll](https://www.nuget.org/packages/CoreAudio/1.16.0) (v1.16.0)### v1.0.0
- First public release.