Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dsccommunity/xcredssp
This module contains DSC resources for configuration of the WSMan Credential Security Support Provider (CredSSP).
https://github.com/dsccommunity/xcredssp
credssp dsc dsc-resources powershell
Last synced: about 2 months ago
JSON representation
This module contains DSC resources for configuration of the WSMan Credential Security Support Provider (CredSSP).
- Host: GitHub
- URL: https://github.com/dsccommunity/xcredssp
- Owner: dsccommunity
- License: mit
- Created: 2015-04-15T22:42:58.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2022-10-23T08:41:02.000Z (about 2 years ago)
- Last Synced: 2024-05-08T22:11:19.675Z (8 months ago)
- Topics: credssp, dsc, dsc-resources, powershell
- Language: PowerShell
- Homepage:
- Size: 72.3 KB
- Stars: 15
- Watchers: 17
- Forks: 10
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# xCredSSP
This module contains DSC resources for the management and
configuration of Credential Security Support Provider (CredSSP).
[](https://dev.azure.com/dsccommunity/xCredSSP/_build/latest?definitionId=52&branchName=main)
[](https://codecov.io/gh/dsccommunity/xCredSSP)
[](https://dsccommunity.visualstudio.com/xCredSSP/_test/analytics?definitionId=52&contextType=build)
[](https://www.powershellgallery.com/packages/xCredSSP/)
[](https://www.powershellgallery.com/packages/xCredSSP/)
## Code of Conduct
This project has adopted this [Code of Conduct](CODE_OF_CONDUCT.md).
## Releases
For each merge to the branch `main` a preview release will be
deployed to [PowerShell Gallery](https://www.powershellgallery.com/).
Periodically a release version tag will be pushed which will deploy a
full release to [PowerShell Gallery](https://www.powershellgallery.com/).
## Contributing
Please check out common DSC Community [contributing guidelines](https://dsccommunity.org/guidelines/contributing).
## Change log
A full list of changes in each version can be found in the [change log](CHANGELOG.md).
## Documentation
The documentation can be found in the [xCredSSP Wiki](https://github.com/dsccommunity/xCredSSP/wiki).
The DSC resources schema files is used to automatically update the
documentation on each PR merge.
## Requirements
This module requires the latest version of PowerShell (v4.0, which ships in
Windows 8.1 or Windows Server 2012R2). To easily use PowerShell 4.0 on older
operating systems, [install WMF 4.0](http://www.microsoft.com/en-us/download/details.aspx?id=40855).
Please read the installation instructions that are present on both the download
page and the release notes for WMF 4.0.
### Examples
You can review the [Examples](/source/Examples) directory in the xCredSSP module
for some general use scenarios for all of the resources that are in the module.
The resource examples are also available in the [xCredSSP Wiki](https://github.com/dsccommunity/xCredSSP/wiki).
## Resources
### xCredSSP
This resource enables or disables Credential Security Support Provider (CredSSP)
authentication on a client or on a server computer, and which server or servers
the client credentials can be delegated to.
#### Parameters
- **Ensure:** Specifies whether the domain trust is present or absent
- **Role**: REQUIRED parameter representing the CredSSP role, and is either
"Server" or "Client"
- **DelegateComputers**: Array of servers to be delegated to, REQUIRED when
Role is set to "Client".
- **SuppressReboot**: Specifies whether a necessary reboot has to be suppressed
or not.
## Examples
### xCredSSP
Enable CredSSP for both server and client roles, and delegate to Server1 and Server2.
```powershell
Configuration EnableCredSSP
{
Import-DscResource -Module xCredSSP
Node localhost
{
xCredSSP Server
{
Ensure = "Present"
Role = "Server"
}
xCredSSP Client
{
Ensure = "Present"
Role = "Client"
DelegateComputers = "Server1","Server2"
}
}
}
```