From d9fceee74c572503dfe659c60a666f9649d36e3e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20MICHEL?= Date: Mon, 22 Jan 2024 16:19:00 +0100 Subject: [PATCH 01/15] Update README.md --- README.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 92d9750..5b80a3f 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# EasyPIM V0.8 +# EasyPIM V1.0.1 Powershell module to manage PIM Azure Resource Role settings with simplicity in mind. Easily manage settings at the subscription level : enter a tenant ID, a subscription ID, a role name @@ -15,7 +15,19 @@ With the export function you can edit your PIM settings in Excel then import you ![image](https://github.com/kayasax/EasyPIM/assets/1241767/79086c31-19fa-4321-a5ac-6767b8d7ace3) +## Installation +This module is available in the PowerShell gallery: [https://www.powershellgallery.com/packages/EasyPIM/](https://www.powershellgallery.com/packages/EasyPIM/), install it with: +```pwsh +Install-Module -Name EasyPIM -Scope CurrentUser +``` + + ## Sample usage +:large_blue_diamond: Get configuration of the role "Webmaster" + ```pwsh + Get-PIMAzureResourcePolicy -TenantID -SubscriptionId -rolename "webmaster" + ``` + :large_blue_diamond: Require justification, ticketing and MFA when activating the role "Webmaster" ```pwsh Set-PIMAzureResourcePolicy -TenantID -SubscriptionId -rolename "webmaster" -ActivationRequirement "Justification","Ticketing","MultiFactorAuthentication" From 90bfa644d5ebb5e9bcd2409aea57f563f45a119a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20MICHEL?= Date: Wed, 24 Jan 2024 12:25:37 +0100 Subject: [PATCH 02/15] Update README.md --- README.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 5b80a3f..3be1dfb 100644 --- a/README.md +++ b/README.md @@ -70,10 +70,11 @@ Backup-PIMAzureResourcePolicy -TenantID -SubscriptionId -SubscriptionId Date: Wed, 24 Jan 2024 12:35:30 +0100 Subject: [PATCH 03/15] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 3be1dfb..54d91ac 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# EasyPIM V1.0.1 +# EasyPIM V1.0.2 Powershell module to manage PIM Azure Resource Role settings with simplicity in mind. Easily manage settings at the subscription level : enter a tenant ID, a subscription ID, a role name From a7c2c2a40a0533032e7ec6d0f5c25ddd3c10028e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20MICHEL?= Date: Fri, 26 Jan 2024 15:40:44 +0100 Subject: [PATCH 04/15] Update README.md --- README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 54d91ac..8005382 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,11 @@ # EasyPIM V1.0.2 Powershell module to manage PIM Azure Resource Role settings with simplicity in mind. -Easily manage settings at the subscription level : enter a tenant ID, a subscription ID, a role name +Easily manage PIM Azure Resource settings (at the subscription level by default) : enter a tenant ID, a subscription ID, a role name then the options you want to set, for example require justification on activation. +If you want to manage the role at another level (Management Group, Resource Group or Resource) please use the `scope` parameter instead of the `subscriptionID`. -With the export function you can edit your PIM settings in Excel then import your changes :wink: +With the export function you can now edit your PIM settings in Excel then import back your changes :wink: ## Key features :boom: Support editing multiple roles at once @@ -21,8 +22,9 @@ This module is available in the PowerShell gallery: [https://www.powershellgalle Install-Module -Name EasyPIM -Scope CurrentUser ``` - ## Sample usage +[Get-PIMAzureResourcePolicy](/wiki/Documentation) + :large_blue_diamond: Get configuration of the role "Webmaster" ```pwsh Get-PIMAzureResourcePolicy -TenantID -SubscriptionId -rolename "webmaster" From 1592544eafc623e39a3201b04af6d71ced8b7b23 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20MICHEL?= Date: Fri, 26 Jan 2024 15:42:09 +0100 Subject: [PATCH 05/15] Update README.md --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 8005382..edd7f24 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,8 @@ Powershell module to manage PIM Azure Resource Role settings with simplicity in mind. Easily manage PIM Azure Resource settings (at the subscription level by default) : enter a tenant ID, a subscription ID, a role name -then the options you want to set, for example require justification on activation. +then the options you want to set, for example require justification on activation. + If you want to manage the role at another level (Management Group, Resource Group or Resource) please use the `scope` parameter instead of the `subscriptionID`. With the export function you can now edit your PIM settings in Excel then import back your changes :wink: @@ -23,7 +24,7 @@ Install-Module -Name EasyPIM -Scope CurrentUser ``` ## Sample usage -[Get-PIMAzureResourcePolicy](/wiki/Documentation) +[Get-PIMAzureResourcePolicy](https://github.com/kayasax/EasyPIM/wiki/Documentation) :large_blue_diamond: Get configuration of the role "Webmaster" ```pwsh From 68987f27693f6e721e8d324b128b9243d4c14742 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20MICHEL?= Date: Fri, 26 Jan 2024 15:43:26 +0100 Subject: [PATCH 06/15] Update README.md --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index edd7f24..4af6fec 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,6 @@ Powershell module to manage PIM Azure Resource Role settings with simplicity in Easily manage PIM Azure Resource settings (at the subscription level by default) : enter a tenant ID, a subscription ID, a role name then the options you want to set, for example require justification on activation. - If you want to manage the role at another level (Management Group, Resource Group or Resource) please use the `scope` parameter instead of the `subscriptionID`. With the export function you can now edit your PIM settings in Excel then import back your changes :wink: From 64a98411736b3c3e0c8fd1600a74839c85ba52df Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20MICHEL?= Date: Fri, 26 Jan 2024 15:51:57 +0100 Subject: [PATCH 07/15] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 4af6fec..17ca48c 100644 --- a/README.md +++ b/README.md @@ -23,7 +23,7 @@ Install-Module -Name EasyPIM -Scope CurrentUser ``` ## Sample usage -[Get-PIMAzureResourcePolicy](https://github.com/kayasax/EasyPIM/wiki/Documentation) +[Get-PIMAzureResourcePolicy]([https://github.com/kayasax/EasyPIM/wiki/Documentation](https://github.com/kayasax/EasyPIM/wiki/Documentation#get-pimazureresourcepolicy) :large_blue_diamond: Get configuration of the role "Webmaster" ```pwsh From 5fa99168965062adc54d1e3d1e062c8068f3b62e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20MICHEL?= Date: Fri, 26 Jan 2024 15:52:59 +0100 Subject: [PATCH 08/15] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 17ca48c..83dac1c 100644 --- a/README.md +++ b/README.md @@ -23,7 +23,7 @@ Install-Module -Name EasyPIM -Scope CurrentUser ``` ## Sample usage -[Get-PIMAzureResourcePolicy]([https://github.com/kayasax/EasyPIM/wiki/Documentation](https://github.com/kayasax/EasyPIM/wiki/Documentation#get-pimazureresourcepolicy) +[Get-PIMAzureResourcePolicy](https://github.com/kayasax/EasyPIM/wiki/Documentation#get-pimazureresourcepolicy) :large_blue_diamond: Get configuration of the role "Webmaster" ```pwsh From cf0f49a89b9cea2b837748e1cc75b743e958ce18 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20MICHEL?= Date: Fri, 26 Jan 2024 16:16:42 +0100 Subject: [PATCH 09/15] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 83dac1c..31ff568 100644 --- a/README.md +++ b/README.md @@ -22,8 +22,8 @@ This module is available in the PowerShell gallery: [https://www.powershellgalle Install-Module -Name EasyPIM -Scope CurrentUser ``` -## Sample usage -[Get-PIMAzureResourcePolicy](https://github.com/kayasax/EasyPIM/wiki/Documentation#get-pimazureresourcepolicy) +## Documentation +[Get-PIMAzureResourcePolicy](https://github.com/kayasax/EasyPIM/wiki/Get%E2%80%90PIMAzureResourcePolicy) :large_blue_diamond: Get configuration of the role "Webmaster" ```pwsh From f8efc6c14ed771dcf01b08029f6a15a5aae3a39c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20MICHEL?= Date: Fri, 26 Jan 2024 16:20:20 +0100 Subject: [PATCH 10/15] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 31ff568..f5011d3 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # EasyPIM V1.0.2 Powershell module to manage PIM Azure Resource Role settings with simplicity in mind. -Easily manage PIM Azure Resource settings (at the subscription level by default) : enter a tenant ID, a subscription ID, a role name +Easily manage PIM Azure Resource settings **at the subscription level by default** : enter a tenant ID, a subscription ID, a role name then the options you want to set, for example require justification on activation. If you want to manage the role at another level (Management Group, Resource Group or Resource) please use the `scope` parameter instead of the `subscriptionID`. From 78041ae299ea59b82de1b746e447863f3492ce52 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20MICHEL?= Date: Fri, 26 Jan 2024 16:22:06 +0100 Subject: [PATCH 11/15] Update README.md --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index f5011d3..8b2a84d 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,8 @@ Easily manage PIM Azure Resource settings **at the subscription level by default then the options you want to set, for example require justification on activation. If you want to manage the role at another level (Management Group, Resource Group or Resource) please use the `scope` parameter instead of the `subscriptionID`. -With the export function you can now edit your PIM settings in Excel then import back your changes :wink: +![image](https://github.com/kayasax/EasyPIM/assets/1241767/79086c31-19fa-4321-a5ac-6767b8d7ace3) + ## Key features :boom: Support editing multiple roles at once @@ -14,7 +15,7 @@ With the export function you can now edit your PIM settings in Excel then import :boom: Import role settings from csv :boom: Backup all roles -![image](https://github.com/kayasax/EasyPIM/assets/1241767/79086c31-19fa-4321-a5ac-6767b8d7ace3) +With the export function you can now edit your PIM settings in Excel then import back your changes :wink: ## Installation This module is available in the PowerShell gallery: [https://www.powershellgallery.com/packages/EasyPIM/](https://www.powershellgallery.com/packages/EasyPIM/), install it with: From f6b248e4455cfdca009eb5eca5ea5128ac64d990 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20MICHEL?= Date: Fri, 26 Jan 2024 16:49:05 +0100 Subject: [PATCH 12/15] Update README.md --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 8b2a84d..cc20e29 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,7 @@ Install-Module -Name EasyPIM -Scope CurrentUser ``` ## Documentation +[Backup-PIMAzureResourcePolicy](https://github.com/kayasax/EasyPIM/wiki/Backup%E2%80%90PIMAzureResourcePolicy) [Get-PIMAzureResourcePolicy](https://github.com/kayasax/EasyPIM/wiki/Get%E2%80%90PIMAzureResourcePolicy) :large_blue_diamond: Get configuration of the role "Webmaster" From ad70c8af9c1fbbc025cf6cdfe0ed538520e4c451 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20MICHEL?= Date: Fri, 26 Jan 2024 17:04:29 +0100 Subject: [PATCH 13/15] Update README.md --- README.md | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index cc20e29..de752d0 100644 --- a/README.md +++ b/README.md @@ -5,9 +5,6 @@ Easily manage PIM Azure Resource settings **at the subscription level by default then the options you want to set, for example require justification on activation. If you want to manage the role at another level (Management Group, Resource Group or Resource) please use the `scope` parameter instead of the `subscriptionID`. -![image](https://github.com/kayasax/EasyPIM/assets/1241767/79086c31-19fa-4321-a5ac-6767b8d7ace3) - - ## Key features :boom: Support editing multiple roles at once :boom: Copy settings from another role @@ -22,10 +19,9 @@ This module is available in the PowerShell gallery: [https://www.powershellgalle ```pwsh Install-Module -Name EasyPIM -Scope CurrentUser ``` +![image](https://github.com/kayasax/EasyPIM/assets/1241767/79086c31-19fa-4321-a5ac-6767b8d7ace3) -## Documentation -[Backup-PIMAzureResourcePolicy](https://github.com/kayasax/EasyPIM/wiki/Backup%E2%80%90PIMAzureResourcePolicy) -[Get-PIMAzureResourcePolicy](https://github.com/kayasax/EasyPIM/wiki/Get%E2%80%90PIMAzureResourcePolicy) +## Sample usage :large_blue_diamond: Get configuration of the role "Webmaster" ```pwsh @@ -78,9 +74,11 @@ Backup-PIMAzureResourcePolicy -TenantID -SubscriptionId Date: Fri, 26 Jan 2024 18:44:17 +0100 Subject: [PATCH 14/15] Update README.md --- README.md | 72 ++++--------------------------------------------------- 1 file changed, 4 insertions(+), 68 deletions(-) diff --git a/README.md b/README.md index de752d0..3fa5903 100644 --- a/README.md +++ b/README.md @@ -44,30 +44,7 @@ Set-PIMAzureResourcePolicy -TenantID -SubscriptionId ```pwsh Set-PIMAzureResourcePolicy -TenantID -SubscriptionId -rolename "webmaster" -ActivationDuration "PT12H" ``` - - -:large_blue_diamond: Copy settings from the role Contributor to the roles webmaster and role1 -```pwsh -Copy-PIMAzureResourcePolicy -TenantID -SubscriptionId -rolename "webmaster", "role1" -copyFrom "contributor" -``` - - -:large_blue_diamond: Export role settings to CSV -```pwsh -Export-PIMAzureResourcePolicy -TenantID -SubscriptionId -rolename "webmaster","contributor" -export -exportFilename .\EXPORTS\roles.csv -``` - - -:large_blue_diamond: Import role settings from CSV -```pwsh -Import-PIMAzureResourcePolicy -TenantID -SubscriptionId -import "c:\temp\roles.csv" -``` - - -:large_blue_diamond: Backup (export all roles) -```pwsh -Backup-PIMAzureResourcePolicy -TenantID -SubscriptionId -``` +More samples in the [documentation](https://github.com/kayasax/EasyPIM/wiki/Documentation) ## Requirement * Az.Accounts module @@ -75,48 +52,7 @@ Backup-PIMAzureResourcePolicy -TenantID -SubscriptionId Date: Fri, 26 Jan 2024 18:46:50 +0100 Subject: [PATCH 15/15] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 3fa5903..2afff9f 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ Powershell module to manage PIM Azure Resource Role settings with simplicity in Easily manage PIM Azure Resource settings **at the subscription level by default** : enter a tenant ID, a subscription ID, a role name then the options you want to set, for example require justification on activation. -If you want to manage the role at another level (Management Group, Resource Group or Resource) please use the `scope` parameter instead of the `subscriptionID`. +:new: If you want to manage the role at another level (Management Group, Resource Group or Resource) please use the `scope` parameter instead of the `subscriptionID`. ## Key features :boom: Support editing multiple roles at once