Skip to content

AzDoAPI_7_IdentitySubjectDescriptors

github-actions[bot] edited this page Aug 18, 2026 · 1 revision

SYNOPSIS

Initializes and updates the identity subject descriptors cache for Azure DevOps groups, users, and service principals.

SYNTAX

AzDoAPI_7_IdentitySubjectDescriptors [[-OrganizationName] <String>] 
 [<CommonParameters>]

DESCRIPTION

The AzDoAPI_7_IdentitySubjectDescriptors function retrieves and updates the identity subject descriptors for Azure DevOps groups, users, and service principals. It uses the provided organization name or a global variable if no organization name is provided. The function enumerates the live groups, users, and service principals from the cache, queries their identities, and updates the cache with the retrieved identity information.

EXAMPLES

EXAMPLE 1

AzDoAPI_7_IdentitySubjectDescriptors -OrganizationName "MyOrganization"
Initializes and updates the identity subject descriptors cache for the specified Azure DevOps organization.

EXAMPLE 2

AzDoAPI_7_IdentitySubjectDescriptors
Initializes and updates the identity subject descriptors cache using the global organization name.

PARAMETERS

-OrganizationName

The name of the Azure DevOps organization. If not provided, the function uses the global variable $Global:DSCAZDO_OrganizationName.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

This function is part of the AzureDevOpsDsc module and is used internally to manage the identity subject descriptors cache.

RELATED LINKS

Commands

Resources

Clone this wiki locally