Microsoft.Graph-användare

Behörigheter

Välj behörigheten eller behörigheterna som markerats som minst privilegierade för det här API:et. Använd endast en behörighet med högre behörighet eller behörigheter om din app kräver att den. Mer information om delegerade behörigheter och programbehörigheter finns i Behörighetstyper. Mer information om dessa behörigheter finns i referensen behörigheter.

Not

Behörigheter för personliga Microsoft-konton kan inte användas för att distribuera Microsoft Graph-resurser som deklarerats i Bicep-filer.

Skrivskyddade befintliga resurser

Välj den minst privilegierade behörigheten i följande tabell för att läsa en Microsoft.Graph/users-resurs med hjälp av nyckelordet existing.

Behörighetstyp	Minst privilegierade behörigheter	Behörigheter med högre privilegier
Delegerad (arbets- eller skolkonto)	User.Read	User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All
Delegerad (personligt Microsoft-konto)	User.Read	User.ReadWrite
Tillämpning	User.Read.All	User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All

Resursformat

Om du vill skapa en Microsoft.Graph/users-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.Graph/users@v1.0' existing = {
  userPrincipalName: 'string'
}

Egenskapsvärden

Användare

Namn	Beskrivning	Värde
apiVersion	Resurs-API-versionen	"v1.0" (ReadOnly)
businessPhones	Användarens telefonnummer. Obs! Även om det är en strängsamling kan endast ett tal anges för den här egenskapen. Skrivskyddad för användare som synkroniserats från den lokala katalogen	string[] (ReadOnly)
deletedDateTime	Datum och tid då objektet togs bort. Alltid null när objektet inte har tagits bort.	sträng (ReadOnly)
displayName	Namnet som visas i adressboken för användaren. Det här värdet är vanligtvis en kombination av användarens förnamn, mellannamn och efternamn. Den här egenskapen krävs när en användare skapas och den kan inte rensas under uppdateringar. Maximal längd är 256 tecken	sträng (ReadOnly)
givenName	Användarens förnamn. Maximal längd är 64 tecken	sträng (ReadOnly)
Id	Den unika identifieraren för en entitet. Skrivskyddad.	sträng (ReadOnly)
jobTitle	Användarens befattning. Maximal längd är 128 tecken	sträng (ReadOnly)
post	SMTP-adressen för användaren, till exempel jeff@contoso.com. Ändringar i den här egenskapen uppdaterar användarens proxyAddresses-samling så att värdet inkluderas som en SMTP-adress. Den här egenskapen får inte innehålla dekortecken. Obs! Vi rekommenderar inte att du uppdaterar den här egenskapen för Azure AD B2C-användarprofiler. Använd egenskapen otherMails i stället	sträng (ReadOnly)
mobilePhone	Användarens primära mobiltelefonnummer. Skrivskyddad för användare som synkroniserats från den lokala katalogen. Maximal längd är 64 tecken	sträng (ReadOnly)
officeLocation	Kontorsplatsen i användarens verksamhetsplats	sträng (ReadOnly)
preferredLanguage	Det föredragna språket för användaren. Det föredragna språkformatet baseras på RFC 4646. Namnet är en kombination av en ISO 639-kod med två bokstäver som är associerad med språket och en ISO 3166-kod med två bokstäver med versaler som är associerad med landet eller regionen. Exempel: "en-US" eller "es-ES"	sträng (ReadOnly)
efternamn	Användarens efternamn (efternamn eller efternamn). Maximal längd är 64 tecken	sträng (ReadOnly)
typ	Resurstypen	"Microsoft.Graph/users" (ReadOnly)
userPrincipalName	Användarens huvudnamn (UPN). UPN är ett inloggningsnamn i Internetstil för användaren baserat på Internetstandarden RFC 822. Enligt konventionen bör det här värdet mappas till användarens e-postnamn. Det allmänna formatet är alias@domain, där domänen måste finnas i klientorganisationens samling av verifierade domäner. Den här egenskapen krävs när en användare skapas. Verifierade domäner för klientorganisationen kan nås från den verifierade egenskapenDomains i organisationen. Obs! Den här egenskapen får inte innehålla dekortecken. Endast följande tecken tillåts A - Z, a - z, 0 - 9, '. - _ ! # ^ ~. En fullständig lista över tillåtna tecken finns i användarnamnsprinciper	sträng (krävs)