Add example of searching user by name

Provide an end2end example on how to initialize users request
with query parameters and search query. Reproduce the same behaviour
as in the Azure AD web console search.

Author: earthquakesan

docs/users_samples.md

@@ -49,4 +49,50 @@ async def get_memberships():
                 group = await client.groups.by_group_id(obj.id).get()
                 if group:
                     print(group.id, group.group_types, group.display_name, group.mail)
-asyncio.run(get_memberships())
+asyncio.run(get_memberships())
+```
+
+## 3. SEARCH USER BY NAME (GET /users/$search?=)
+
+```py
+import asyncio
+
+from azure.identity import AzureCliCredential
+from msgraph import GraphServiceClient
+from msgraph.generated.users.users_request_builder import UsersRequestBuilder
+
+
+async def find_user(user_name: str, client: GraphServiceClient) -> None:
+    # The query used here is the same when searching for users in Azure AD via web console
+    query_params = UsersRequestBuilder.UsersRequestBuilderGetQueryParameters(
+        search=[
+            f'("displayName:{user_name}" OR "mail:{user_name}" OR "userPrincipalName:{user_name}" OR "givenName:{user_name}" OR "surName:{user_name}" OR "otherMails:{user_name}")'
+        ],
+    )
+    request_configuration = (
+        UsersRequestBuilder.UsersRequestBuilderGetRequestConfiguration(
+            query_parameters=query_params, headers={"ConsistencyLevel": "eventual"}
+        )
+    )
+
+    response = await client.users.get(request_configuration=request_configuration)
+    if response.value:
+        user = response.value[0]
+        print(
+            f"Found user for {user_name} in the Azure AD with user principal name {user.user_principal_name} and display name {user.display_name}"
+        )
+    else:
+        print(f"{user_name} user in the Azure AD not found")
+
+
+def main():
+    # Use cli credentials to authenticate against Azure
+    # Before running script do `az login`
+    credential = AzureCliCredential()
+    scopes = ["https://graph.microsoft.com/.default"]
+    client = GraphServiceClient(credentials=credential, scopes=scopes)
+    asyncio.run(find_user("john", client))
+
+
+main()
+```