From 2870337d5c2a64533ea5158ee5b0afb96c13b2cf Mon Sep 17 00:00:00 2001 From: Antoine Boot <2473792+Antiohne@users.noreply.github.com> Date: Sat, 14 Feb 2026 16:15:28 +0000 Subject: [PATCH 1/6] Improve documentation --- .../Public/Graph/Groups/Get-AdoGroup.ps1 | 26 +++++++++++++++---- 1 file changed, 21 insertions(+), 5 deletions(-) diff --git a/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 b/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 index 3d861bf..b312e75 100644 --- a/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 +++ b/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 @@ -16,7 +16,10 @@ Optional. A comma separated list of user subject subtypes to reduce the retrieved results, e.g. Microsoft.IdentityModel.Claims.ClaimsIdentity .PARAMETER Name - Optional. A group's display name to filter the retrieved results. + Optional. A group's display name to filter the retrieved results. Supports wildcards for pattern matching. + + .PARAMETER GroupDescriptor + Optional. The descriptor of a specific group to retrieve. When provided, retrieves a single group by its descriptor. .PARAMETER Version The API version to use. Default is '7.2-preview.1'. @@ -25,6 +28,18 @@ .OUTPUTS PSCustomObject + Returns one or more group objects with the following properties: + - `subjectKind`: This field identifies the type of the graph subject (ex: Group, Scope, User). + - `description`: A short phrase to help human readers disambiguate groups with similar names + - `domain`: This represents the name of the container of origin for a graph member. (For MSA this is "Windows Live ID", for AD the name of the domain, for AAD the tenantID of the directory, for VSTS groups the ScopeId, etc) + - `principalName`: This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS. + - `mailAddress`: The email address of record for a given graph member. This may be different than the principal name. + - `origin`: The type of source provider for the origin identifier (ex:AD, AAD, MSA) + - `originId`: The unique identifier from the system of origin. Typically a sid, object id or Guid. Linking and unlinking operations can cause this value to change for a user because the user is not backed by a different provider and has a different unique id in the new provider. + - `displayName`: This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider. + - `descriptor`: The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations. + - `collectionUri`: The collection URI. + .LINK - https://learn.microsoft.com/en-us/rest/api/azure/devops/graph/groups/get - https://learn.microsoft.com/en-us/rest/api/azure/devops/graph/groups/list @@ -167,13 +182,14 @@ foreach ($g_ in $groups) { $obj = [ordered]@{ - displayName = $g_.displayName - originId = $g_.originId - principalName = $g_.principalName - origin = $g_.origin subjectKind = $g_.subjectKind description = $g_.description + domain = $g_.domain + principalName = $g_.principalName mailAddress = $g_.mailAddress + origin = $g_.origin + originId = $g_.originId + displayName = $g_.displayName descriptor = $g_.descriptor collectionUri = $CollectionUri } From 162bb48f1aaec06e9f6463d02005c6bac49a6773 Mon Sep 17 00:00:00 2001 From: Antoine Boot <2473792+Antiohne@users.noreply.github.com> Date: Sat, 14 Feb 2026 17:47:27 +0100 Subject: [PATCH 2/6] Add domain property to output object --- CHANGELOG.md | 17 +++- docs/Get-AdoGroup.md | 94 ++++++++++--------- .../Public/Graph/Groups/Get-AdoGroup.ps1 | 6 +- .../Tests/Graph/Groups/Get-AdoGroup.Tests.ps1 | 31 +++--- 4 files changed, 85 insertions(+), 63 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f53858c..eecd1c2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -19,7 +19,20 @@ All notable changes to this project will be documented in this file.
--> -## [0.4.0] +## [UNRELEASED] + +### Summary +- _None_ + +### What's Changed +- feat(Get-AdoGroup): Add `domain` property to output + +### Breaking Changes +- _None_ + +
+ +## [0.4.0] - 2026-02-13 ### Summary Feature release adding repository initialization support, enhanced user entitlement data, and improved check/approval resource management. @@ -29,6 +42,7 @@ Feature release adding repository initialization support, enhanced user entitlem - feat: Add `ResourceId` parameter to all Check and Approval cmdlets - feat: Add `New-AdoPushInitialCommit` cmdlet for creating initial commits in Azure DevOps repositories - chore: Using namespace `System.Collections.Generic` declaration at the module root +- chore(Build.ps1): Update module version to 0.4.0 ### Breaking Changes - _None_ @@ -76,7 +90,6 @@ Hotfix release focused on bug fixes and code quality improvements. Achieved 100% - chore: Update CHANGELOG to reflect recent changes and fixes - chore: Update build version to 0.2.3 - ### Breaking Changes - With the output names update in `Add-AdoTeamIteration` and `Get-AdoTeamIteration` cmdlets the output names `team` and `project` are not available anymore, use `teamName` and `projectName` instead. diff --git a/docs/Get-AdoGroup.md b/docs/Get-AdoGroup.md index a180709..bbcffda 100644 --- a/docs/Get-AdoGroup.md +++ b/docs/Get-AdoGroup.md @@ -2,9 +2,9 @@ document type: cmdlet external help file: Azure.DevOps.PSModule-Help.xml HelpUri: https://learn.microsoft.com/en-us/rest/api/azure/devops/graph/groups/list -Locale: en-NL +Locale: nl-NL Module Name: Azure.DevOps.PSModule -ms.date: 01/02/2026 +ms.date: 02-14-2026 PlatyPS schema version: 2024-05-01 title: Get-AdoGroup --> @@ -20,12 +20,18 @@ Get a single or multiple groups in an Azure DevOps organization. ## SYNTAX -### __AllParameterSets +### ListGroups (Default) -```text -Get-AdoGroup [[-CollectionUri] ] [[-ScopeDescriptor] ] [[-SubjectTypes] ] - [[-Name] ] [[-GroupDescriptor] ] [[-Version] ] - [-WhatIf] [-Confirm] [] +```powershell +Get-AdoGroup [-CollectionUri ] [-ScopeDescriptor ] [-SubjectTypes ] + [-Name ] [-Version ] [] +``` + +### ByDescriptor + +```powershell +Get-AdoGroup [-CollectionUri ] [-GroupDescriptor ] [-Version ] + [] ``` ## ALIASES @@ -58,7 +64,7 @@ $project = Get-AdoProject -Name 'my-project-1' $projectDescriptor = (Get-AdoDescriptor -StorageKey $project.Id) $params = @{ - CollectionUri = 'https://dev.azure.com/my-org' + CollectionUri = 'https://dev.azure.com/my-org' ScopeDescriptor = $projectDescriptor SubjectTypes = 'vssgp' } @@ -74,7 +80,7 @@ Retrieves all groups in the specified project with subject types 'vssgp'. ```powershell $params = @{ SubjectTypes = 'vssgp' - ScopeDescriptor = $prjDscr + ScopeDescriptor = $projectDescriptor Name = @( 'Project Administrators', 'Contributors' @@ -123,10 +129,10 @@ AcceptedValues: [] HelpMessage: '' ``` -### -ScopeDescriptor +### -GroupDescriptor Optional. -Specify a non-default scope (collection, project) to search for groups. +The descriptor of a specific group to retrieve. When provided, retrieves a single group by its descriptor. ```yaml Type: System.String @@ -134,10 +140,10 @@ DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: -- Name: (All) +- Name: ByDescriptor Position: Named IsRequired: false - ValueFromPipeline: false + ValueFromPipeline: true ValueFromPipelineByPropertyName: true ValueFromRemainingArguments: false DontShow: false @@ -145,43 +151,41 @@ AcceptedValues: [] HelpMessage: '' ``` -### -SubjectTypes +### -Name Optional. -A comma separated list of user subject subtypes to reduce the retrieved results, e.g. Microsoft.IdentityModel.Claims.ClaimsIdentity +A group's display name to filter the retrieved results. +Supports wildcards for pattern matching. ```yaml Type: System.String[] -DefaultValue: ('vssgp', 'aadgp') +DefaultValue: '' SupportsWildcards: false -Aliases: [] +Aliases: +- DisplayName +- GroupName ParameterSets: -- Name: (All) +- Name: ListGroups Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: true ValueFromRemainingArguments: false DontShow: false -AcceptedValues: -- vssgp -- aadgp +AcceptedValues: [] HelpMessage: '' ``` -### -Name +### -ScopeDescriptor Optional. -A group's display name to filter the retrieved results. -Supports wildcards for pattern matching. +Specify a non-default scope (collection, project) to search for groups. ```yaml -Type: System.String[] +Type: System.String DefaultValue: '' SupportsWildcards: false -Aliases: -- DisplayName -- GroupName +Aliases: [] ParameterSets: - Name: ListGroups Position: Named @@ -194,22 +198,22 @@ AcceptedValues: [] HelpMessage: '' ``` -### -GroupDescriptor +### -SubjectTypes Optional. -The descriptor of a specific group to retrieve. -When provided, retrieves a single group by its descriptor. +A comma separated list of user subject subtypes to reduce the retrieved results, e.g. +Microsoft.IdentityModel.Claims.ClaimsIdentity ```yaml -Type: System.String -DefaultValue: '' +Type: System.String[] +DefaultValue: "@('vssgp', 'aadgp')" SupportsWildcards: false Aliases: [] ParameterSets: -- Name: ByDescriptor +- Name: ListGroups Position: Named IsRequired: false - ValueFromPipeline: true + ValueFromPipeline: false ValueFromPipelineByPropertyName: true ValueFromRemainingArguments: false DontShow: false @@ -260,16 +264,16 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ### PSCustomObject Returns one or more group objects with the following properties: -- displayName: The display name of the group -- originId: The origin ID of the group -- principalName: The principal name of the group -- origin: The origin of the group (e.g., 'aad', 'vsts') -- subjectKind: The subject kind (e.g., 'group') -- description: The description of the group -- mailAddress: The mail address of the group -- descriptor: The descriptor of the group -- collectionUri: The collection URI used for the query -- continuationToken: (Optional) Token for retrieving the next page of results +- `subjectKind`: This field identifies the type of the graph subject (ex: Group, Scope, User). +- `description`: A short phrase to help human readers disambiguate groups with similar names +- `domain`: This represents the name of the container of origin for a graph member. (For MSA this is "Windows Live ID", for AD the name of the domain, for AAD the tenantID of the directory, for VSTS groups the ScopeId, etc) +- `principalName`: This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS. +- `mailAddress`: The email address of record for a given graph member. This may be different than the principal name. +- `origin`: The type of source provider for the origin identifier (ex:AD, AAD, MSA) +- `originId`: The unique identifier from the system of origin. Typically a sid, object id or Guid. Linking and unlinking operations can cause this value to change for a user because the user is not backed by a different provider and has a different unique id in the new provider. +- `displayName`: This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider. +- `descriptor`: The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations. +- `collectionUri`: The collection URI used for the query. ## NOTES diff --git a/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 b/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 index b312e75..bfd1bb7 100644 --- a/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 +++ b/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 @@ -22,7 +22,7 @@ Optional. The descriptor of a specific group to retrieve. When provided, retrieves a single group by its descriptor. .PARAMETER Version - The API version to use. Default is '7.2-preview.1'. + The API version to use for the request. Default is '7.2-preview.1'. The -preview flag must be supplied in the api-version for this request to work. .OUTPUTS @@ -38,7 +38,7 @@ - `originId`: The unique identifier from the system of origin. Typically a sid, object id or Guid. Linking and unlinking operations can cause this value to change for a user because the user is not backed by a different provider and has a different unique id in the new provider. - `displayName`: This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider. - `descriptor`: The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations. - - `collectionUri`: The collection URI. + - `collectionUri`: The collection URI used for the query. .LINK - https://learn.microsoft.com/en-us/rest/api/azure/devops/graph/groups/get @@ -54,7 +54,7 @@ $projectDescriptor = (Get-AdoDescriptor -StorageKey $project.Id) $params = @{ - CollectionUri = 'https://dev.azure.com/my-org' + CollectionUri = 'https://dev.azure.com/my-org' ScopeDescriptor = $projectDescriptor SubjectTypes = 'vssgp' } diff --git a/src/Azure.DevOps.PSModule/Tests/Graph/Groups/Get-AdoGroup.Tests.ps1 b/src/Azure.DevOps.PSModule/Tests/Graph/Groups/Get-AdoGroup.Tests.ps1 index bee3e46..380d737 100644 --- a/src/Azure.DevOps.PSModule/Tests/Graph/Groups/Get-AdoGroup.Tests.ps1 +++ b/src/Azure.DevOps.PSModule/Tests/Graph/Groups/Get-AdoGroup.Tests.ps1 @@ -18,24 +18,26 @@ Describe 'Get-AdoGroup' { $mockScopeDescriptor = 'scp.00000000-0000-0000-0000-000000000002' $mockGroup1 = [PSCustomObject]@{ - displayName = 'Project Administrators' - originId = '00000000-0000-0000-0000-000000000001' - principalName = '[TestProject]\Project Administrators' - origin = 'vsts' subjectKind = 'group' description = 'Admin group' - mailAddress = '' + domain = 'vstfs://Classification/TeamProject/00000000-0000-0000-0000-000000000001' + principalName = '[TestProject]\Project Administrators' + mailAddress = $null + origin = 'vsts' + originId = '00000000-0000-0000-0000-000000000001' + displayName = 'Project Administrators' descriptor = 'vssgp.00000000-0000-0000-0000-000000000001' } $mockGroup2 = [PSCustomObject]@{ - displayName = 'Contributors' - originId = '00000000-0000-0000-0000-000000000002' - principalName = '[TestProject]\Contributors' - origin = 'vsts' subjectKind = 'group' description = 'Contributor group' - mailAddress = '' + domain = 'vstfs://Classification/TeamProject/00000000-0000-0000-0000-000000000002' + principalName = '[TestProject]\Contributors' + mailAddress = $null + origin = 'vsts' + originId = '00000000-0000-0000-0000-000000000002' + displayName = 'Contributors' descriptor = 'vssgp.00000000-0000-0000-0000-000000000002' } @@ -66,11 +68,14 @@ Describe 'Get-AdoGroup' { $result = Get-AdoGroup -CollectionUri $mockCollectionUri # Assert - $result[0].PSObject.Properties.Name | Should -Contain 'displayName' - $result[0].PSObject.Properties.Name | Should -Contain 'originId' + $result[0].PSObject.Properties.Name | Should -Contain 'subjectKind' + $result[0].PSObject.Properties.Name | Should -Contain 'description' + $result[0].PSObject.Properties.Name | Should -Contain 'domain' $result[0].PSObject.Properties.Name | Should -Contain 'principalName' + $result[0].PSObject.Properties.Name | Should -Contain 'mailAddress' $result[0].PSObject.Properties.Name | Should -Contain 'origin' - $result[0].PSObject.Properties.Name | Should -Contain 'subjectKind' + $result[0].PSObject.Properties.Name | Should -Contain 'originId' + $result[0].PSObject.Properties.Name | Should -Contain 'displayName' $result[0].PSObject.Properties.Name | Should -Contain 'descriptor' $result[0].PSObject.Properties.Name | Should -Contain 'collectionUri' } From 8fcdc2b80927b9b4978b515d9ca3f8de455194b1 Mon Sep 17 00:00:00 2001 From: Antoine Boot <2473792+Antiohne@users.noreply.github.com> Date: Sat, 14 Feb 2026 17:53:57 +0100 Subject: [PATCH 3/6] feat(Get-AdoGroup): Add `domain` property to output (#126) --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index eecd1c2..2487e53 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -25,7 +25,7 @@ All notable changes to this project will be documented in this file. - _None_ ### What's Changed -- feat(Get-AdoGroup): Add `domain` property to output +- feat(Get-AdoGroup): Add `domain` property to output (#126) ### Breaking Changes - _None_ From 24c78f43f6fdfde2a3d46bbb17e0c77e572d2987 Mon Sep 17 00:00:00 2001 From: Antoine Boot <2473792+Antiohne@users.noreply.github.com> Date: Mon, 16 Feb 2026 13:04:36 +0000 Subject: [PATCH 4/6] Remove backticks --- docs/Get-AdoGroup.md | 20 +++++++++---------- .../Public/Graph/Groups/Get-AdoGroup.ps1 | 20 +++++++++---------- 2 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/Get-AdoGroup.md b/docs/Get-AdoGroup.md index bbcffda..1502060 100644 --- a/docs/Get-AdoGroup.md +++ b/docs/Get-AdoGroup.md @@ -264,16 +264,16 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ### PSCustomObject Returns one or more group objects with the following properties: -- `subjectKind`: This field identifies the type of the graph subject (ex: Group, Scope, User). -- `description`: A short phrase to help human readers disambiguate groups with similar names -- `domain`: This represents the name of the container of origin for a graph member. (For MSA this is "Windows Live ID", for AD the name of the domain, for AAD the tenantID of the directory, for VSTS groups the ScopeId, etc) -- `principalName`: This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS. -- `mailAddress`: The email address of record for a given graph member. This may be different than the principal name. -- `origin`: The type of source provider for the origin identifier (ex:AD, AAD, MSA) -- `originId`: The unique identifier from the system of origin. Typically a sid, object id or Guid. Linking and unlinking operations can cause this value to change for a user because the user is not backed by a different provider and has a different unique id in the new provider. -- `displayName`: This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider. -- `descriptor`: The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations. -- `collectionUri`: The collection URI used for the query. +- subjectKind: This field identifies the type of the graph subject (ex: Group, Scope, User). +- description: A short phrase to help human readers disambiguate groups with similar names +- domain: This represents the name of the container of origin for a graph member. (For MSA this is "Windows Live ID", for AD the name of the domain, for AAD the tenantID of the directory, for VSTS groups the ScopeId, etc) +- principalName: This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS. +- mailAddress: The email address of record for a given graph member. This may be different than the principal name. +- origin: The type of source provider for the origin identifier (ex:AD, AAD, MSA) +- originId: The unique identifier from the system of origin. Typically a sid, object id or Guid. Linking and unlinking operations can cause this value to change for a user because the user is not backed by a different provider and has a different unique id in the new provider. +- displayName: This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider. +- descriptor: The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations. +- collectionUri: The collection URI used for the query. ## NOTES diff --git a/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 b/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 index bfd1bb7..e52a946 100644 --- a/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 +++ b/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 @@ -29,16 +29,16 @@ PSCustomObject Returns one or more group objects with the following properties: - - `subjectKind`: This field identifies the type of the graph subject (ex: Group, Scope, User). - - `description`: A short phrase to help human readers disambiguate groups with similar names - - `domain`: This represents the name of the container of origin for a graph member. (For MSA this is "Windows Live ID", for AD the name of the domain, for AAD the tenantID of the directory, for VSTS groups the ScopeId, etc) - - `principalName`: This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS. - - `mailAddress`: The email address of record for a given graph member. This may be different than the principal name. - - `origin`: The type of source provider for the origin identifier (ex:AD, AAD, MSA) - - `originId`: The unique identifier from the system of origin. Typically a sid, object id or Guid. Linking and unlinking operations can cause this value to change for a user because the user is not backed by a different provider and has a different unique id in the new provider. - - `displayName`: This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider. - - `descriptor`: The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations. - - `collectionUri`: The collection URI used for the query. + - subjectKind: This field identifies the type of the graph subject (ex: Group, Scope, User). + - description: A short phrase to help human readers disambiguate groups with similar names + - domain: This represents the name of the container of origin for a graph member. (For MSA this is "Windows Live ID", for AD the name of the domain, for AAD the tenantID of the directory, for VSTS groups the ScopeId, etc) + - principalName: This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS. + - mailAddress: The email address of record for a given graph member. This may be different than the principal name. + - origin: The type of source provider for the origin identifier (ex:AD, AAD, MSA) + - originId: The unique identifier from the system of origin. Typically a sid, object id or Guid. Linking and unlinking operations can cause this value to change for a user because the user is not backed by a different provider and has a different unique id in the new provider. + - displayName: This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider. + - descriptor: The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations. + - collectionUri: The collection URI used for the query. .LINK - https://learn.microsoft.com/en-us/rest/api/azure/devops/graph/groups/get From 964c9226af1907700eeb6d641d47696ac84c2025 Mon Sep 17 00:00:00 2001 From: Antoine Boot <2473792+Antiohne@users.noreply.github.com> Date: Tue, 17 Feb 2026 13:41:59 +0000 Subject: [PATCH 5/6] Remove PSCustomObject documentation --- docs/Get-AdoGroup.md | 12 ------------ .../Public/Graph/Groups/Get-AdoGroup.ps1 | 12 ------------ 2 files changed, 24 deletions(-) diff --git a/docs/Get-AdoGroup.md b/docs/Get-AdoGroup.md index 1502060..d26571a 100644 --- a/docs/Get-AdoGroup.md +++ b/docs/Get-AdoGroup.md @@ -263,18 +263,6 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ### PSCustomObject -Returns one or more group objects with the following properties: -- subjectKind: This field identifies the type of the graph subject (ex: Group, Scope, User). -- description: A short phrase to help human readers disambiguate groups with similar names -- domain: This represents the name of the container of origin for a graph member. (For MSA this is "Windows Live ID", for AD the name of the domain, for AAD the tenantID of the directory, for VSTS groups the ScopeId, etc) -- principalName: This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS. -- mailAddress: The email address of record for a given graph member. This may be different than the principal name. -- origin: The type of source provider for the origin identifier (ex:AD, AAD, MSA) -- originId: The unique identifier from the system of origin. Typically a sid, object id or Guid. Linking and unlinking operations can cause this value to change for a user because the user is not backed by a different provider and has a different unique id in the new provider. -- displayName: This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider. -- descriptor: The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations. -- collectionUri: The collection URI used for the query. - ## NOTES - Retrieves groups in an Azure DevOps organization diff --git a/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 b/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 index e52a946..56501df 100644 --- a/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 +++ b/src/Azure.DevOps.PSModule/Public/Graph/Groups/Get-AdoGroup.ps1 @@ -28,18 +28,6 @@ .OUTPUTS PSCustomObject - Returns one or more group objects with the following properties: - - subjectKind: This field identifies the type of the graph subject (ex: Group, Scope, User). - - description: A short phrase to help human readers disambiguate groups with similar names - - domain: This represents the name of the container of origin for a graph member. (For MSA this is "Windows Live ID", for AD the name of the domain, for AAD the tenantID of the directory, for VSTS groups the ScopeId, etc) - - principalName: This is the PrincipalName of this graph member from the source provider. The source provider may change this field over time and it is not guaranteed to be immutable for the life of the graph member by VSTS. - - mailAddress: The email address of record for a given graph member. This may be different than the principal name. - - origin: The type of source provider for the origin identifier (ex:AD, AAD, MSA) - - originId: The unique identifier from the system of origin. Typically a sid, object id or Guid. Linking and unlinking operations can cause this value to change for a user because the user is not backed by a different provider and has a different unique id in the new provider. - - displayName: This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider. - - descriptor: The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations. - - collectionUri: The collection URI used for the query. - .LINK - https://learn.microsoft.com/en-us/rest/api/azure/devops/graph/groups/get - https://learn.microsoft.com/en-us/rest/api/azure/devops/graph/groups/list From ad64e9349b42438db5cdf99893fde80e00c86273 Mon Sep 17 00:00:00 2001 From: Antoine Boot <2473792+Antiohne@users.noreply.github.com> Date: Tue, 17 Feb 2026 16:42:12 +0000 Subject: [PATCH 6/6] Update changelog --- CHANGELOG.md | 1 - 1 file changed, 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 5f05491..1386b1b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -19,7 +19,6 @@ All notable changes to this project will be documented in this file.
--> - ## [UNRELEASED] ### Summary