{"id":19954053,"url":"https://github.com/mkht/wifiprofilemanagementdsc","last_synced_at":"2025-05-03T19:31:56.301Z","repository":{"id":57667091,"uuid":"153395597","full_name":"mkht/WiFiProfileManagementDsc","owner":"mkht","description":"PowerShell DSC resource for manage WiFi profile.","archived":false,"fork":false,"pushed_at":"2021-12-18T12:17:36.000Z","size":9,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-20T04:47:08.661Z","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/mkht.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":"2018-10-17T04:30:54.000Z","updated_at":"2024-12-10T03:04:28.000Z","dependencies_parsed_at":"2022-09-02T14:11:02.627Z","dependency_job_id":null,"html_url":"https://github.com/mkht/WiFiProfileManagementDsc","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/mkht%2FWiFiProfileManagementDsc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkht%2FWiFiProfileManagementDsc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkht%2FWiFiProfileManagementDsc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mkht%2FWiFiProfileManagementDsc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mkht","download_url":"https://codeload.github.com/mkht/WiFiProfileManagementDsc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252242052,"owners_count":21717098,"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-13T01:18:47.588Z","updated_at":"2025-05-03T19:31:56.014Z","avatar_url":"https://github.com/mkht.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"WiFiProfileManagementDsc\n====\n\nPowerShell DSC resource for manage WiFi profile.\n\n----\n## Installation\nFrom [PowerShell Gallery](https://www.powershellgallery.com/packages/WiFiProfileManagementDsc/).\n```PowerShell\nInstall-Module -Name WiFiProfileManagementDsc\n```\n\n### Dependencies\n* [WiFiProfileManagement](https://github.com/jcwalker/WiFiProfileManagement) by jcwalker\n\n----\n## DSC Resources\n* **WiFiProfile** PowerShell DSC resource for manage WiFi profile.\n\n### WiFiProfile\n* **Ensure**: Ensures that the profile is Present or Absent.\n* **ProfileName**: The name of the profile. This is a Key property.\n* **ConnectionMode**: Indicates whether connection to the wireless LAN should be automatic ('auto') or initiated ('manual') by user. The default is 'auto'.\n* **Authentication**: Specifies the authentication method to be used to connect to the wireless LAN. ('open', 'shared', 'WPA', 'WPAPSK', 'WPA2', 'WPA2PSK', 'WPA3SAE', 'WPA3ENT192', \"OWE\")\n* **Encryption**: Sets the data encryption to use to connect to the wireless LAN. ('none', 'WEP', 'TKIP', 'AES', 'GCMP256')\n* **Credential**: The network key or passpharse of the wireless profile in the form of a PSCredential.\n* **ConnectHiddenSSID**: Specifies whether the profile can connect to networks which does not broadcast SSID. The default is false.\n* **EAPType**: (Only 802.1X) Specifies the type of 802.1X EAP. You can select \"PEAP\"(aka MSCHAPv2) or \"TLS\".\n* **ServerNames**: (Only 802.1X) Specifies the server that will be connect to validate certification.\n* **TrustedRootCA**: (Only 802.1X) Specifies the certificate thumbprint of the Trusted Root CA.\n* **AuthMode**: (Only 802.1X) Specifies the type of credentials used for authentication. ('machineOrUser', 'machine', 'user', 'guest')\n* **XmlProfile**: The XML representation of the profile.\n\n\n### Examples\nIf you wish to see fully functional scripts, See `Examples` folder.\n\n+ **Example 1**: Create WiFi profile (WPA2-Personal)\n```Powershell\nConfiguration Example1\n{\n    Import-DscResource -ModuleName WiFiProfileManagementDsc\n    WiFiProfile WPA2Personal\n    {\n        Ensure = 'Present'\n        ProfileName = 'MyWiFi'\n        ConnectionMode = 'auto'\n        Authentication = 'WPA2PSK'\n        Encryption = 'AES'\n        ConnectHiddenSSID = $true\n        Credential = $CredentialForConnect #Only use Password. UserName will be ignored.\n    }\n}\n```\n\n+ **Example 2**: Create WiFi profile (WPA2-Enterprise)\n```Powershell\nConfiguration Example2\n{\n    Import-DscResource -ModuleName WiFiProfileManagementDsc\n    WiFiProfile WPA2Enterprise\n    {\n        Ensure = 'Present'\n        ProfileName = 'OneXWiFi'\n        ConnectionMode = 'manual'\n        Authentication = 'WPA2'\n        Encryption = 'AES'\n        ConnectHiddenSSID = $true\n        EAPType = 'PEAP'\n        TrustedRootCA = '041101cca5b336a9c6e50d173489f5929e1b4b00'  #optional\n        AuthMode = 'machine'  #optional\n    }\n}\n```\n\n+ **Example 3**: Remove WiFi profile\n```Powershell\nConfiguration Example3\n{\n    Import-DscResource -ModuleName WiFiProfileManagementDsc\n    WiFiProfile RemoveWiFi\n    {\n        Ensure = 'Absent'\n        ProfileName = 'MyWiFi'\n    }\n}\n```\n\n----\n## Versions\n\n### Unreleased\n\n### 1.0.0\n  + First public release.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmkht%2Fwifiprofilemanagementdsc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmkht%2Fwifiprofilemanagementdsc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmkht%2Fwifiprofilemanagementdsc/lists"}