external help file | Module Name | online version | schema | ms.subservice |
---|---|---|---|---|
Microsoft.Graph.Beta.Identity.DirectoryManagement-help.xml |
Microsoft.Graph.Beta.Identity.DirectoryManagement |
2.0.0 |
entra-directory-management |
Use this API to add a member (user, group, or device) to an administrative unit or to create a new group within an administrative unit. All group types can be created within an administrative unit. Note: Currently, it's only possible to add one member at a time to an administrative unit.`
New-MgBetaAdministrativeUnitMemberByRef -AdministrativeUnitId <String> [-ResponseHeadersVariable <String>]
-OdataId <String> [-AdditionalProperties <Hashtable>] [-Headers <IDictionary>] [-PassThru]
[-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]
New-MgBetaAdministrativeUnitMemberByRef -AdministrativeUnitId <String> -BodyParameter <IReferenceCreate>
[-ResponseHeadersVariable <String>] [-Headers <IDictionary>] [-PassThru] [-ProgressAction <ActionPreference>]
[-WhatIf] [-Confirm] [<CommonParameters>]
New-MgBetaAdministrativeUnitMemberByRef -InputObject <IIdentityDirectoryManagementIdentity>
[-ResponseHeadersVariable <String>] -OdataId <String> [-AdditionalProperties <Hashtable>]
[-Headers <IDictionary>] [-PassThru] [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm]
[<CommonParameters>]
New-MgBetaAdministrativeUnitMemberByRef -InputObject <IIdentityDirectoryManagementIdentity>
-BodyParameter <IReferenceCreate> [-ResponseHeadersVariable <String>] [-Headers <IDictionary>] [-PassThru]
[-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]
Use this API to add a member (user, group, or device) to an administrative unit or to create a new group within an administrative unit. All group types can be created within an administrative unit. Note: Currently, it's only possible to add one member at a time to an administrative unit.`
Permissions [!INCLUDE permissions-table]
Import-Module Microsoft.Graph.Beta.Identity.DirectoryManagement
$params = @{
"@odata.id" = "https://graph.microsoft.com/beta/groups/{id}"
}
New-MgBetaAdministrativeUnitMemberByRef -AdministrativeUnitId $administrativeUnitId -BodyParameter $params
This example shows how to use the New-MgBetaAdministrativeUnitMemberByRef Cmdlet. To learn about permissions for this resource, see the permissions reference.
Additional Parameters
Type: Hashtable
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
The unique identifier of administrativeUnit
Type: String
Parameter Sets: CreateExpanded, Create
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
Type: IReferenceCreate
Parameter Sets: Create, CreateViaIdentity
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
Optional headers that will be added to the request.
Type: IDictionary
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.
Type: IIdentityDirectoryManagementIdentity
Parameter Sets: CreateViaIdentityExpanded, CreateViaIdentity
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
The entity reference URL of the resource. For example, https://graph.microsoft.com/v1.0/directoryObjects/{id}.
Type: String
Parameter Sets: CreateExpanded, CreateViaIdentityExpanded
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Returns true when the command succeeds
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
{{ Fill ProgressAction Description }}
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Optional Response Headers Variable.
Type: String
Parameter Sets: (All)
Aliases: RHV
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
COMPLEX PARAMETER PROPERTIES
To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.
BODYPARAMETER <IReferenceCreate>
: .
[(Any) <Object>]
: This indicates any property can be added to this object. OdataId<String>
: The entity reference URL of the resource. For example, https://graph.microsoft.com/v1.0/directoryObjects/{id}.
INPUTOBJECT <IIdentityDirectoryManagementIdentity>
: Identity Parameter
[AdministrativeUnitId <String>]
: The unique identifier of administrativeUnit[AllowedValueId <String>]
: The unique identifier of allowedValue[AttributeSetId <String>]
: The unique identifier of attributeSet[CertificateAuthorityAsEntityId <String>]
: The unique identifier of certificateAuthorityAsEntity[CertificateBasedApplicationConfigurationId <String>]
: The unique identifier of certificateBasedApplicationConfiguration[CommandId <String>]
: The unique identifier of command[CommerceSubscriptionId <String>]
: Alternate key of companySubscription[CompanySubscriptionId <String>]
: The unique identifier of companySubscription[ContractId <String>]
: The unique identifier of contract[CustomSecurityAttributeDefinitionId <String>]
: The unique identifier of customSecurityAttributeDefinition[DeviceId <String>]
: The unique identifier of device[DeviceLocalCredentialInfoId <String>]
: The unique identifier of deviceLocalCredentialInfo[DirectoryObjectId <String>]
: The unique identifier of directoryObject[DirectoryRoleId <String>]
: The unique identifier of directoryRole[DirectoryRoleTemplateId <String>]
: The unique identifier of directoryRoleTemplate[DirectorySettingId <String>]
: The unique identifier of directorySetting[DirectorySettingTemplateId <String>]
: The unique identifier of directorySettingTemplate[DomainDnsRecordId <String>]
: The unique identifier of domainDnsRecord[DomainId <String>]
: The unique identifier of domain[ExtensionId <String>]
: The unique identifier of extension[ExternalUserProfileId <String>]
: The unique identifier of externalUserProfile[FeatureRolloutPolicyId <String>]
: The unique identifier of featureRolloutPolicy[IdentityProviderBaseId <String>]
: The unique identifier of identityProviderBase[ImpactedResourceId <String>]
: The unique identifier of impactedResource[InboundSharedUserProfileUserId <String>]
: The unique identifier of inboundSharedUserProfile[InternalDomainFederationId <String>]
: The unique identifier of internalDomainFederation[ManagedTenantAlertId <String>]
: The unique identifier of managedTenantAlert[ManagementActionId <String>]
: The unique identifier of managementAction[OcpSubscriptionId <String>]
: Alternate key of companySubscription[OnPremisesDirectorySynchronizationId <String>]
: The unique identifier of onPremisesDirectorySynchronization[OrgContactId <String>]
: The unique identifier of orgContact[OrganizationId <String>]
: The unique identifier of organization[OrganizationalBrandingLocalizationId <String>]
: The unique identifier of organizationalBrandingLocalization[OutboundSharedUserProfileUserId <String>]
: The unique identifier of outboundSharedUserProfile[PendingExternalUserProfileId <String>]
: The unique identifier of pendingExternalUserProfile[ProfileCardPropertyId <String>]
: The unique identifier of profileCardProperty[RecommendationId <String>]
: The unique identifier of recommendation[RoleTemplateId <String>]
: Alternate key of directoryRole[ScopedRoleMembershipId <String>]
: The unique identifier of scopedRoleMembership[SharedEmailDomainId <String>]
: The unique identifier of sharedEmailDomain[SharedEmailDomainInvitationId <String>]
: The unique identifier of sharedEmailDomainInvitation[SubscribedSkuId <String>]
: The unique identifier of subscribedSku[TenantId <String>]
: The unique identifier of tenant[TenantReferenceTenantId <String>]
: The unique identifier of tenantReference[TenantTagId <String>]
: The unique identifier of tenantTag[UsageRightId <String>]
: The unique identifier of usageRight[UserId <String>]
: The unique identifier of user
https://learn.microsoft.com/graph/api/administrativeunit-post-members?view=graph-rest-beta