feat: Updating with latest version

fix(functions): 🚑 Login check did not work. PAT was always used

feat(functions): Added a way to function to clear authentication header

refactor: 🚚 Moving all the functions in different folders

feat: Added function for branch control on pipeline

feat(workflow): Added psscriptanalyzer

chore(release): v0.1.0 [skip ci]

fix(worklows): 🚀 Added repo parameter

chore(release): v0.2.0 [skip ci]

chore(release): v0.3.0 [skip ci]

chore(release): v0.4.0 [skip ci]

fix: 🚀 Fixing psgallery Api key

fix: 🚀 Added build task to psake

feat: adding version to publish

fix: typo

fix: changed to publish-module

fix: Added update-modulemanifest

fix: typo

fix: -as [version]

fix: changed to init

fix: typo

fix:typo

fix: removed cast

fix: testing build

fix: Switch order

fix: replaced path

fix: update manifest

fix: added functionsToExport to workflow

fix: testing version from tripss action

fix: fixed version

fix: typo

fix: testing new github release

Author: Dylan-Prins

.devcontainer/Dockerfile

@@ -14,7 +14,7 @@ ARG USER_UID=1000
 ARG USER_GID=$USER_UID
 
 # install git iproute2, process tools
-RUN apt-get update && apt-get -y install git openssh-client less iproute2 procps \
+RUN apt-get update && apt-get -y install git openssh-client less iproute2 procps gnupg2 python3 python3-pip \
     # Create a non-root user to use if preferred - see https://aka.ms/vscode-remote/containers/non-root-user.
     && groupadd --gid $USER_GID $USERNAME \
     && useradd -s /bin/bash --uid $USER_UID --gid $USER_GID -m $USERNAME \
@@ -28,3 +28,5 @@ RUN apt-get update && apt-get -y install git openssh-client less iproute2 procps
     && apt-get clean -y \
     && rm -rf /var/lib/apt/lists/*
 
+RUN pip install mkdocs-awesome-pages-plugin
+

.devcontainer/devcontainer.json

@@ -1,26 +1,35 @@
 {
-    "name": "PowerShell",
-    "dockerFile": "Dockerfile",
-    // "image": "mcr.microsoft.com/powershell",
-
-    // Set *default* container specific settings.json values on container create.
-    "settings": {
-        "terminal.integrated.shell.linux": "/usr/bin/pwsh"
+  "name": "PowerShell",
+  "dockerFile": "Dockerfile",
+  // "image": "mcr.microsoft.com/powershell",
+  // Set *default* container specific settings.json values on container create.
+  "settings": {
+    "terminal.integrated.profiles.linux": {
+      "PowerShell": {
+        "path": "/usr/bin/pwsh",
+        "args": []
+      }
     },
-
-    // Add the IDs of extensions you want installed when the container is created.
-    "extensions": [
-        "ms-vscode.powershell",
-        "davidanson.vscode-markdownlint"
-    ],
-
-    // Use 'forwardPorts' to make a list of ports inside the container available locally.
-    // "forwardPorts": [],
-
-    // Bootstrap build modules
-    "postCreateCommand": "pwsh -c './build.ps1 -Task Init -Bootstrap'",
-
-    // Uncomment to connect as a non-root user. See https://aka.ms/vscode-remote/containers/non-root.
-    // "remoteUser": "vscode"
+    "terminal.integrated.defaultProfile.windows": "PowerShell"
+  },
+  // Add the IDs of extensions you want installed when the container is created.
+  "extensions": [
+    "ms-vscode.powershell-preview",
+    "davidanson.vscode-markdownlint",
+    "eamodio.gitlens",
+    "GitHub.vscode-pull-request-github",
+    "pspester.pester-test",
+    "mhutchie.git-graph",
+    "cschleiden.vscode-github-actions",
+    "rangav.vscode-thunder-client",
+    "Gruntfuggly.todo-tree",
+    "ms-vscode.azure-account",
+    "vivaxy.vscode-conventional-commits"
+  ],
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  // "forwardPorts": [],
+  // Bootstrap build modules
+  "postCreateCommand": "pwsh -c './build.ps1 -Task Init -Bootstrap'"
+  // Uncomment to connect as a non-root user. See https://aka.ms/vscode-remote/containers/non-root.
+  // "remoteUser": "vscode"
 }
-

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @WeAreInSpark/expertteam-deployment-automation

.github/CONTRIBUTING.md

@@ -5,52 +5,48 @@ Below are some guidelines that will help make the process as smooth as possible.
 
 ## Getting Started
 
-- Make sure you have a [GitHub account](https://github.com/signup/free)
 - Submit a new issue, assuming one does not already exist.
   - Clearly describe the issue including steps to reproduce when it is a bug.
   - Make sure you fill in the earliest version that you know has the issue.
-- Fork the repository on GitHub
 
 ## Suggesting Enhancements
 
-I want to know what you think is missing from InfrastructureAsCode and how it can be made better.
+We want to know what you think is missing from InfrastructureAsCode and how it can be made better.
 
 - When submitting an issue for an enhancement, please be as clear as possible about why you think the enhancement is needed and what the benefit of it would be.
 
 ## Making Changes
 
-- From your fork of the repository, create a topic branch where work on your change will take place.
-- To quickly create a topic branch based on master; `git checkout -b my_contribution master`.
-  Please avoid working directly on the `master` branch.
+- Create a topic branch where work on your change will take place.
+- To quickly create a topic branch based on master; `git checkout -b my_contribution master`. <br>
+  We have policies in place to prevent direct committing on main to prevent error and malicious acts.
 - Make commits of logical units.
 - Check for unnecessary whitespace with `git diff --check` before committing.
-- Please follow the prevailing code conventions in the repository.
-  Differences in style make the code harder to understand for everyone.
+- Check the build workflows when creating a PR. Our standards are added in CI as much as we can.
 - Make sure your commit messages are in the proper format.
 
 ```
     Add more cowbell to Get-Something.ps1
 
     The functionality of Get-Something would be greatly improved if there was a little
     more 'pizzazz' added to it. I propose a cowbell. Adding more cowbell has been
-    shown in studies to both increase one's mojo, and cement one's status
-    as a rock legend.
+    shown in studies to both increase one's work satisfaction, and cement one's status
+    as a rock legend. We gotta have more cowbell!
 ```
 
 - Make sure you have added all the necessary Pester tests for your changes.
 - Run _all_ Pester tests in the module to assure nothing else was accidentally broken.
 
 ## Documentation
 
-I am infallible and as such my documenation needs no corectoin.
-In the highly unlikely event that that is _not_ the case, commits to update or add documentation are highly apprecaited.
+There is always something to improve in documentation. Please let us know via an issue or share a PR to improve our documentation.
 
 ## Submitting Changes
 
-- Push your changes to a topic branch in your fork of the repository.
-- Submit a pull request to the main repository.
-- Once the pull request has been reviewed and accepted, it will be merged with the master branch.
-- Celebrate
+- Push your changes to a topic branch.
+- Submit a pull request to the main branch.
+- Once the pull request has been reviewed and accepted, it will be merged with the main branch.
+- Celebrate 🎊
 
 ## Additional Resources
 
@@ -59,4 +55,3 @@ In the highly unlikely event that that is _not_ the case, commits to update or a
 - [GitHub pull request documentation](https://help.github.com/send-pull-requests/)
 - [GitHub Flow guide](https://guides.github.com/introduction/flow/)
 - [GitHub's guide to contributing to open source projects](https://guides.github.com/activities/contributing-to-open-source/)
-

.github/workflows/CI.yaml

@@ -0,0 +1,28 @@
+name: CI
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "AzureDevOpsPowerShellAPI/**"
+      - "docs/**"
+jobs:
+  Docs:
+    name: Deploy docs to GitHub Pages
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Test
+        shell: pwsh
+        run: |
+          ./build.ps1 -Task Build -Bootstrap
+      - name: Build
+        uses: Tiryoh/actions-mkdocs@v0
+        with:
+          requirements: "mkdocs.txt"
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site

.github/workflows/Documentation.yaml

@@ -0,0 +1,57 @@
+name: release
+
+on:
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Release module
+    runs-on: windows-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Conventional Changelog Action
+        id: changelog
+        uses: TriPSs/conventional-changelog-action@v3
+        with:
+          output-file: "false"
+          skip-version-file: "false"
+          skip-commit: "true"
+          skip-git-pull: "true"
+
+      - name: Release
+        uses: softprops/action-gh-release@v1
+        with:
+          draft: false
+          prerelease: false
+          body: ${{ steps.changelog.outputs.clean_changelog }}
+          tag_name: ${{ steps.changelog.outputs.tag }}
+          name: Release ${{ steps.changelog.outputs.tag }}
+
+      # - name: Create Release
+      #   uses: actions/create-release@v1
+      #   if: ${{ steps.changelog.outputs.skipped == 'false' }}
+      #   env:
+      #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      #   with:
+      #     tag_name: ${{ steps.changelog.outputs.tag }}
+      #     release_name: Release ${{ steps.changelog.outputs.tag }}
+      #     body: ${{ steps.changelog.outputs.clean_changelog }}
+      #     draft: false
+      #     prerelease: false
+
+      - name: Release module to PSGallery
+        shell: pwsh
+        env:
+          PSGALLERY_API_KEY: ${{ secrets.PAT }}
+        run: |
+          $version = "${{ steps.changelog.outputs.tag }}" -replace "v", ""
+          $public = @(Get-ChildItem -Path (Join-Path -Path ".\AzureDevOpsPowerShellAPI" -ChildPath 'Public\*.ps1')  -Recurse -ErrorAction Stop)
+
+          Update-ModuleManifest -Path ".\AzureDevOpsPowerShellAPI\AzureDevOpsPowerShellAPI.psd1" -ModuleVersion "$version"
+          Update-ModuleManifest -Path ".\AzureDevOpsPowerShellAPI\AzureDevOpsPowerShellAPI.psd1" -FunctionsToExport $public.Basename
+
+          Publish-Module  -NuGetApiKey "$env:PSGALLERY_API_KEY" -Repository PSGallery -path ".\AzureDevOpsPowerShellAPI"

.github/workflows/Release.yaml

@@ -0,0 +1,28 @@
+name: Tests
+on: [pull_request]
+jobs:
+  test:
+    name: Run Tests
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v3
+      - name: Test
+        shell: pwsh
+        run: |
+          Install-Module -Name Microsoft.Graph.Applications -Force
+          Install-Module -Name Az.Accounts -Force
+          Install-Module -Name Az.KeyVault -Force
+          ./build.ps1 -Task Test -Bootstrap
+  validate-commits:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out code into the Go module directory
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Commitsar check
+        uses: docker://aevea/commitsar

.github/workflows/Tests.yaml

@@ -0,0 +1,49 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+#
+# https://github.com/microsoft/action-psscriptanalyzer
+# For more information on PSScriptAnalyzer in general, see
+# https://github.com/PowerShell/PSScriptAnalyzer
+
+name: PSScriptAnalyzer
+
+on:
+  push:
+    branches: [ "main"]
+  pull_request:
+    branches: [ "main" ]
+  schedule:
+    - cron: '27 5 * * 3'
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    permissions:
+      contents: read # for actions/checkout to fetch code
+      security-events: write # for github/codeql-action/upload-sarif to upload SARIF results
+      actions: read # only required for a private repository by github/codeql-action/upload-sarif to get the Action run status
+    name: PSScriptAnalyzer
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Run PSScriptAnalyzer
+        uses: microsoft/psscriptanalyzer-action@6b2948b1944407914a58661c49941824d149734f
+        with:
+          # Check https://github.com/microsoft/action-psscriptanalyzer for more info about the options.
+          # The below set up runs PSScriptAnalyzer to your entire repository and runs some basic security rules.
+          path: .\
+          recurse: true
+          # Include your own basic security rules. Removing this option will run all the rules
+          includeRule: '"PSAvoidGlobalAliases", "PSAvoidUsingConvertToSecureStringWithPlainText"'
+          output: results.sarif
+
+      # Upload the SARIF file generated in the previous step
+      - name: Upload SARIF results file
+        uses: github/codeql-action/upload-sarif@v2
+        with:
+          sarif_file: results.sarif

.github/workflows/powershell.yml

@@ -1,2 +1,3 @@
 # Don't check in the Output dir
 Output/
+site/