Added examples to Entitlement management v1.0 cmdlets

src/Identity.Governance/Identity.Governance/examples/v1.0-beta/Get-MgEntitlementManagementAccessPackage.md

@@ -9,7 +9,7 @@ AccessPackageCatalog            : Microsoft.Graph.PowerShell.Models.MicrosoftGra
 AccessPackageResourceRoleScopes :
 AccessPackagesIncompatibleWith  :
 CatalogId                       : 54152ecb-c65d-47f2-8a4d-ba2732de0a7b
-CreatedBy                       : admin@M365x814237.onmicrosoft.com
+CreatedBy                       : Contoso.onmicrosoft.com
 CreatedDateTime                 : 11/5/2021 8:03:39 AM
 Description                     :
 DisplayName                     : Marketing Campaign
@@ -18,7 +18,7 @@ IncompatibleAccessPackages      :
 IncompatibleGroups              :
 IsHidden                        : False
 IsRoleScopesVisible             : False
-ModifiedBy                      : admin@M365x814237.onmicrosoft.com
+ModifiedBy                      : Contoso.onmicrosoft.com
 ModifiedDateTime                : 11/5/2021 9:08:44 AM
 AdditionalProperties            : {}
 
@@ -27,7 +27,7 @@ AccessPackageCatalog            : Microsoft.Graph.PowerShell.Models.MicrosoftGra
 AccessPackageResourceRoleScopes :
 AccessPackagesIncompatibleWith  :
 CatalogId                       : 54152ecb-c65d-47f2-8a4d-ba2732de0a7b
-CreatedBy                       : admin@M365x814237.onmicrosoft.com
+CreatedBy                       : Contoso.onmicrosoft.com
 CreatedDateTime                 : 9/15/2021 7:23:44 AM
 Description                     : Access for Sales and Marketing users and guests
 DisplayName                     : Sales and Marketing
@@ -36,7 +36,7 @@ IncompatibleAccessPackages      :
 IncompatibleGroups              :
 IsHidden                        : False
 IsRoleScopesVisible             : False
-ModifiedBy                      : admin@M365x814237.onmicrosoft.com
+ModifiedBy                      : Contoso.onmicrosoft.com
 ModifiedDateTime                : 9/15/2021 7:23:44 AM
 AdditionalProperties            : {}
 ```
@@ -55,7 +55,7 @@ AccessPackageCatalog            : Microsoft.Graph.PowerShell.Models.MicrosoftGra
 AccessPackageResourceRoleScopes :
 AccessPackagesIncompatibleWith  :
 CatalogId                       : 54152ecb-c65d-47f2-8a4d-ba2732de0a7b
-CreatedBy                       : admin@M365x814237.onmicrosoft.com
+CreatedBy                       : Contoso.onmicrosoft.com
 CreatedDateTime                 : 11/5/2021 8:03:39 AM
 Description                     :
 DisplayName                     : Marketing Campaign
@@ -64,7 +64,7 @@ IncompatibleAccessPackages      :
 IncompatibleGroups              :
 IsHidden                        : False
 IsRoleScopesVisible             : False
-ModifiedBy                      : admin@M365x814237.onmicrosoft.com
+ModifiedBy                      : Contoso.onmicrosoft.com
 ModifiedDateTime                : 11/5/2021 9:08:44 AM
 AdditionalProperties            : {[@odata.context, https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/accessPackages/$entity]}
 

src/Identity.Governance/Identity.Governance/examples/v1.0/Get-MgEntitlementManagementAccessPackage.md

@@ -1,18 +1,47 @@
-### Example 1: {{ Add title here }}
+### Example 1: Get a list of all access packages
+
 ```powershell
-PS C:\> {{ Add code here }}
+Connect-MgGraph -Scopes 'EntitlementManagement.ReadWrite.All'
+Get-MgEntitlementManagementAccessPackage | Format-List
+
+AssignmentPolicies   :
+Catalog              : Microsoft.Graph.PowerShell.Models.MicrosoftGraphAccessPackageCatalog1
+CreatedDateTime      : 5/4/2022 10:02:17 AM
+Description          :
+DisplayName          : Marketing Campaign
+Id                   : 5c17e2d4-b421-4c32-ac09-8b96cddd3042
+IsHidden             : False
+ModifiedDateTime     : 5/4/2022 10:07:59 AM
+AdditionalProperties : {}
 
-{{ Add output here }}
+AssignmentPolicies   :
+Catalog              : Microsoft.Graph.PowerShell.Models.MicrosoftGraphAccessPackageCatalog1
+CreatedDateTime      : 1/13/2022 6:48:14 AM
+Description          : Access for Sales and Marketing users and guests
+DisplayName          : Sales and Marketing
+Id                   : 3f367184-5e17-47d6-b505-4cb43b471875
+IsHidden             : False
+ModifiedDateTime     : 1/13/2022 6:48:14 AM
+AdditionalProperties : {}
 ```
 
-{{ Add description here }}
+This examples returns all access packages.
+
+### Example 2: Get access package by Id
 
-### Example 2: {{ Add title here }}
 ```powershell
-PS C:\> {{ Add code here }}
+Connect-MgGraph -Scopes 'EntitlementManagement.ReadWrite.All'
+Get-MgEntitlementManagementAccessPackage -AccessPackageId '5c17e2d4-b421-4c32-ac09-8b96cddd3042'| Format-List
 
-{{ Add output here }}
+AssignmentPolicies   :
+Catalog              : Microsoft.Graph.PowerShell.Models.MicrosoftGraphAccessPackageCatalog1
+CreatedDateTime      : 5/4/2022 10:02:17 AM
+Description          :
+DisplayName          : Marketing Campaign
+Id                   : 5c17e2d4-b421-4c32-ac09-8b96cddd3042
+IsHidden             : False
+ModifiedDateTime     : 5/4/2022 10:07:59 AM
+AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#identityGovernance/entitlementManagement/accessPackages/$entity]}
 ```
 
-{{ Add description here }}
-
+This example returns the access package of the specified Id.

src/Identity.Governance/Identity.Governance/examples/v1.0/Get-MgEntitlementManagementAccessPackageCatalog.md

@@ -7,6 +7,8 @@ PS C:\> {{ Add code here }}
 
 {{ Add description here }}
 
+
+
 ### Example 2: {{ Add title here }}
 ```powershell
 PS C:\> {{ Add code here }}

src/Identity.Governance/Identity.Governance/examples/v1.0/Get-MgEntitlementManagementAssignmentPolicy.md

@@ -1,18 +1,59 @@
-### Example 1: {{ Add title here }}
+### Example 1: Create an access package assignment policy
+
 ```powershell
-PS C:\> {{ Add code here }}
+Connect-MgGraph -Scopes 'EntitlementManagement.ReadWrite.All'
 
-{{ Add output here }}
-```
+$params = @{
+	DisplayName = "New Policy"
+	Description = "policy for assignment"
+	AllowedTargetScope = "notSpecified"
+	SpecificAllowedTargets = @(
+	)
+	Expiration = @{
+		EndDateTime = $null
+		Duration = $null
+		Type = "noExpiration"
+	}
+	RequestorSettings = @{
+		EnableTargetsToSelfAddAccess = $false
+		EnableTargetsToSelfUpdateAccess = $false
+		EnableTargetsToSelfRemoveAccess = $false
+		AllowCustomAssignmentSchedule = $true
+		EnableOnBehalfRequestorsToAddAccess = $false
+		EnableOnBehalfRequestorsToUpdateAccess = $false
+		EnableOnBehalfRequestorsToRemoveAccess = $false
+		OnBehalfRequestors = @(
+		)
+	}
+	RequestApprovalSettings = @{
+		IsApprovalRequiredForAdd = $false
+		IsApprovalRequiredForUpdate = $false
+		Stages = @(
+		)
+	}
+	AccessPackage = @{
+		Id = "a2e1ca1e-4e56-47d2-9daa-e2ba8d12a82b"
+	}
+}
 
-{{ Add description here }}
+New-MgEntitlementManagementAssignmentPolicy -BodyParameter $params
 
-### Example 2: {{ Add title here }}
-```powershell
-PS C:\> {{ Add code here }}
-
-{{ Add output here }}
+AccessPackage            : Microsoft.Graph.PowerShell.Models.MicrosoftGraphAccessPackage1
+AllowedTargetScope       : notSpecified
+AutomaticRequestSettings : Microsoft.Graph.PowerShell.Models.MicrosoftGraphAccessPackageAutomaticRequestSettings
+Catalog                  : Microsoft.Graph.PowerShell.Models.MicrosoftGraphAccessPackageCatalog1
+CreatedDateTime          : 9/15/2022 2:35:56 PM
+Description              : policy for assignment
+DisplayName              : New Policy
+Expiration               : Microsoft.Graph.PowerShell.Models.MicrosoftGraphExpirationPattern
+Id                       : c39f299c-4f4b-4065-b3ea-5b607e867738
+ModifiedDateTime         : 9/15/2022 2:35:56 PM
+RequestApprovalSettings  : Microsoft.Graph.PowerShell.Models.MicrosoftGraphAccessPackageAssignmentApprovalSettings
+RequestorSettings        : Microsoft.Graph.PowerShell.Models.MicrosoftGraphAccessPackageAssignmentRequestorSettings
+ReviewSettings           : Microsoft.Graph.PowerShell.Models.MicrosoftGraphAccessPackageAssignmentReviewSettings
+SpecificAllowedTargets   : {}
+AdditionalProperties     : {[@odata.context,
+                           https://graph.microsoft.com/v1.0/$metadata#identityGovernance/entitlementManagement/assignmentPolicies/$entity]}
 ```
 
-{{ Add description here }}
-
+This example shows a request to create an access package assignment policy.

src/Identity.Governance/Identity.Governance/examples/v1.0/Get-MgEntitlementManagementCatalog.md

@@ -1,18 +1,42 @@
-### Example 1: {{ Add title here }}
+### Example 1: Get a list of all access package catalogs
+
 ```powershell
-PS C:\> {{ Add code here }}
+Connect-MgGraph -Scopes 'EntitlementManagement.ReadWrite.All'
+
+Get-MgEntitlementManagementCatalog | fl
 
-{{ Add output here }}
+AccessPackages       :
+CatalogType          : serviceDefault
+CreatedDateTime      : 1/13/2022 6:47:56 AM
+Description          : Built-in catalog.
+DisplayName          : General
+Id                   : 88d3e491-5247-4209-9b56-c4c95d9694e9
+IsExternallyVisible  : True
+ModifiedDateTime     : 1/13/2022 6:47:56 AM
+State                : published
+AdditionalProperties : {}
 ```
 
-{{ Add description here }}
+This examples gets a list of all the access package catalogs.
+
+### Example 2: Get a access package catalog by the AccessPackageCatalogId
 
-### Example 2: {{ Add title here }}
 ```powershell
-PS C:\> {{ Add code here }}
+Connect-MgGraph -Scopes 'EntitlementManagement.ReadWrite.All'
+Get-MgEntitlementManagementCatalog -AccessPackageCatalogId '88d3e491-5247-4209-9b56-c4c95d9694e9' |fl
 
-{{ Add output here }}
+AccessPackages       :
+CatalogType          : serviceDefault
+CreatedDateTime      : 1/13/2022 6:47:56 AM
+Description          : Built-in catalog.
+DisplayName          : General
+Id                   : 88d3e491-5247-4209-9b56-c4c95d9694e9
+IsExternallyVisible  : True
+ModifiedDateTime     : 1/13/2022 6:47:56 AM
+State                : published
+AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#identityGovernance/entitlementManag
+                       ement/catalogs/$entity]}
 ```
 
-{{ Add description here }}
+his examples gets access package catalog for the specified access package Id.
 

src/Identity.Governance/Identity.Governance/examples/v1.0/Get-MgEntitlementManagementSetting.md

@@ -1,18 +1,13 @@
-### Example 1: {{ Add title here }}
-```powershell
-PS C:\> {{ Add code here }}
-
-{{ Add output here }}
-```
+### Example 1: Get the identity governance settings
 
-{{ Add description here }}
-
-### Example 2: {{ Add title here }}
 ```powershell
-PS C:\> {{ Add code here }}
+Connect-MgGraph -Scopes 'EntitlementManagement.ReadWrite.All'
 
-{{ Add output here }}
-```
+Get-MgEntitlementManagementSetting
 
-{{ Add description here }}
+Id        ExternalUserLifecycleAction
+--        ---------------------------
+singleton blockSignInAndDelete
+```
 
+This example returns the identity governance settings.

src/Identity.Governance/Identity.Governance/examples/v1.0/New-MgEntitlementManagementAccessPackage.md

@@ -1,18 +1,27 @@
-### Example 1: {{ Add title here }}
-```powershell
-PS C:\> {{ Add code here }}
-
-{{ Add output here }}
-```
+### Example 1: Create an access package 
 
-{{ Add description here }}
-
-### Example 2: {{ Add title here }}
 ```powershell
-PS C:\> {{ Add code here }}
+Connect-MgGraph -Scopes 'EntitlementManagement.ReadWrite.All'
 
-{{ Add output here }}
-```
+$params = @{
+DisplayName = "Marketing Campaign"
+Description = "Marketing Campaign"
+IsHidden = $false
+Catalog = @{
+Id = "88d3e491-5247-4209-9b56-c4c95d9694e9"
+}
+ }
+New-MgEntitlementManagementAccessPackage -BodyParameter $params
 
-{{ Add description here }}
+AssignmentPolicies   :
+Catalog              : Microsoft.Graph.PowerShell.Models.MicrosoftGraphAccessPackageCatalog1
+CreatedDateTime      : 9/15/2022 9:48:28 AM
+Description          : Marketing Campaign
+DisplayName          : Marketing Campaign
+Id                   : fd6ec077-e933-418f-9b6f-df88a54f9eee
+IsHidden             : False
+ModifiedDateTime     : 9/15/2022 9:48:28 AM
+AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#identityGovernance/entitlementManagement/accessPackages/$entity]}
+```
 
+This example creates an access package with he defined display name under the specified catalog.

src/Identity.Governance/Identity.Governance/examples/v1.0/Remove-MgEntitlementManagementAccessPackage.md

@@ -1,18 +1,9 @@
 ### Example 1: {{ Add title here }}
-```powershell
-PS C:\> {{ Add code here }}
-
-{{ Add output here }}
-```
 
-{{ Add description here }}
-
-### Example 2: {{ Add title here }}
 ```powershell
-PS C:\> {{ Add code here }}
+Connect-MgGraph -Scopes 'EntitlementManagement.ReadWrite.All'
 
-{{ Add output here }}
+Remove-MgEntitlementManagementAccessPackage -AccessPackageId 'bc041fda-b3ba-41fc-b911-ca95f7aac656'
 ```
 
-{{ Add description here }}
-
+This example removes the specified access package.

src/Identity.Governance/Identity.Governance/examples/v1.0/Remove-MgEntitlementManagementAccessPackageAssignmentPolicy.md

@@ -1,18 +1,9 @@
-### Example 1: {{ Add title here }}
-```powershell
-PS C:\> {{ Add code here }}
-
-{{ Add output here }}
-```
+### Example 1: Remove an access package assignment policy
 
-{{ Add description here }}
-
-### Example 2: {{ Add title here }}
 ```powershell
-PS C:\> {{ Add code here }}
+Connect-MgGraph -Scopes 'EntitlementManagement.ReadWrite.All'
 
-{{ Add output here }}
+Remove-MgEntitlementManagementAssignmentPolicy -AccessPackageAssignmentPolicyId '62073739-d160-40e4-8367-87e88d85d083'
 ```
 
-{{ Add description here }}
-
+This example removes the specified assignment policy.