Merge pull request #131 from microsoftgraph/po/0.2.0Release

0.2.0 Release

Author: peombwa

config/ModuleMetadata.json

@@ -8,7 +8,7 @@
     "projectUri": "https://github.com/microsoftgraph/msgraph-sdk-powershell",
     "iconUri": "https://raw.githubusercontent.com/microsoftgraph/g-raph/master/g-raph.png",
     "tags": "MicrosoftGraph;Microsoft;Office365;Graph;PowerShell;GraphServiceClient;Outlook;OneDrive;AzureAD;GraphAPI;Productivity;SharePoint;Intune;SDK;",
-    "releaseNotes": "Initial release of Microsoft.Graph module.",
+    "releaseNotes": "See https://aka.ms/GraphPowerShell-Release.",
     "assemblyOriginatorKeyFile": "35MSSharedLib1024.snk",
     "version": "0.2.0"
 }

openApiDocs/Beta/Analytics.yml

@@ -1,9 +1,9 @@
 openapi: 3.0.1
 info:
   title: Analytics
-  version: v1.0-Beta
+  version: v1.0-beta
 servers:
-  - url: https://graph.microsoft.com/Beta/
+  - url: https://graph.microsoft.com/beta/
     description: Core
 paths:
   /activitystatistics:
@@ -1452,14 +1452,17 @@ components:
               type: array
               items:
                 $ref: '#/components/schemas/microsoft.graph.trending'
+              description: Calculated relationship identifying trending documents. Trending documents can be stored in OneDrive or in SharePoint sites.
             shared:
               type: array
               items:
                 $ref: '#/components/schemas/microsoft.graph.sharedInsight'
+              description: Calculated relationship identifying documents shared with a user. Documents can be shared as email attachments or as OneDrive for Business links sent in emails.
             used:
               type: array
               items:
                 $ref: '#/components/schemas/microsoft.graph.usedInsight'
+              description: 'Calculated relationship identifying documents viewed and modified by a user. Includes documents the user used in OneDrive for Business, SharePoint, opened as email attachments, and as link attachments from sources like Box, DropBox and Google Drive.'
       example:
         id: string (identifier)
         trending:
@@ -1508,6 +1511,7 @@ components:
       properties:
         id:
           type: string
+          description: Read-only.
       example:
         id: string (identifier)
     microsoft.graph.trending:
@@ -1518,6 +1522,7 @@ components:
           properties:
             weight:
               type: number
+              description: 'Value indicating how much the document is currently trending. The larger the number, the more the document is currently trending around the user (the more relevant it is). Returned documents are sorted by this value.'
               format: double
             resourceVisualization:
               $ref: '#/components/schemas/microsoft.graph.resourceVisualization'
@@ -1596,13 +1601,16 @@ components:
         sharedDateTime:
           pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
           type: string
+          description: 'The date and time the file was last shared. The timestamp represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: 2014-01-01T00:00:00Z. Read-only.'
           format: date-time
           nullable: true
         sharingSubject:
           type: string
+          description: The subject with which the document was shared.
           nullable: true
         sharingType:
           type: string
+          description: 'Determines the way the document was shared, can be by a ''Link'', ''Attachment'', ''Group'', ''Site''.'
           nullable: true
         sharingReference:
           $ref: '#/components/schemas/microsoft.graph.resourceReference'
@@ -1620,27 +1628,35 @@ components:
       properties:
         title:
           type: string
+          description: The item's title text.
           nullable: true
         type:
           type: string
+          description: The item's media type. Can be used for filtering for a specific file based on a specific type. See below for supported types.
           nullable: true
         mediaType:
           type: string
+          description: The item's media type. Can be used for filtering for a specific type of file based on supported IANA Media Mime Types. Note that not all Media Mime Types are supported.
           nullable: true
         previewImageUrl:
           type: string
+          description: A URL leading to the preview image for the item.
           nullable: true
         previewText:
           type: string
+          description: A preview text for the item.
           nullable: true
         containerWebUrl:
           type: string
+          description: A path leading to the folder in which the item is stored.
           nullable: true
         containerDisplayName:
           type: string
+          description: 'A string describing where the item is stored. For example, the name of a SharePoint site or the user name identifying the owner of the OneDrive storing the item.'
           nullable: true
         containerType:
           type: string
+          description: Can be used for filtering by the type of container in which the file is stored. Such as Site or OneDriveBusiness.
           nullable: true
       example:
         title: string
@@ -1657,12 +1673,15 @@ components:
       properties:
         webUrl:
           type: string
+          description: A URL leading to the referenced item.
           nullable: true
         id:
           type: string
+          description: The item's unique identifier.
           nullable: true
         type:
           type: string
+          description: 'A string value that can be used to classify the item, such as ''microsoft.graph.driveItem'''
           nullable: true
       example:
         webUrl: string
@@ -1675,11 +1694,13 @@ components:
         lastAccessedDateTime:
           pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
           type: string
+          description: 'The date and time the resource was last accessed by the user. The timestamp represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: 2014-01-01T00:00:00Z. Read-only.'
           format: date-time
           nullable: true
         lastModifiedDateTime:
           pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
           type: string
+          description: 'The date and time the resource was last modified by the user. The timestamp represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: 2014-01-01T00:00:00Z. Read-only.'
           format: date-time
           nullable: true
       example:
@@ -1698,12 +1719,15 @@ components:
       properties:
         displayName:
           type: string
+          description: The display name of the user who shared the item.
           nullable: true
         id:
           type: string
+          description: The id of the user who shared the item.
           nullable: true
         address:
           type: string
+          description: The email address of the user who shared the item.
           nullable: true
       example:
         displayName: string

openApiDocs/Beta/Bookings.yml

@@ -1,9 +1,9 @@
 openapi: 3.0.1
 info:
   title: Bookings
-  version: v1.0-Beta
+  version: v1.0-beta
 servers:
-  - url: https://graph.microsoft.com/Beta/
+  - url: https://graph.microsoft.com/beta/
     description: Core
 paths:
   /bookingBusinesses:
@@ -1834,22 +1834,27 @@ components:
               type: array
               items:
                 $ref: '#/components/schemas/microsoft.graph.bookingAppointment'
+              description: All appointments in this business.
             calendarView:
               type: array
               items:
                 $ref: '#/components/schemas/microsoft.graph.bookingAppointment'
+              description: A calendar view of appointments in this business.
             customers:
               type: array
               items:
                 $ref: '#/components/schemas/microsoft.graph.bookingCustomer'
+              description: All customers of this business.
             services:
               type: array
               items:
                 $ref: '#/components/schemas/microsoft.graph.bookingService'
+              description: All services offered by this business.
             staffMembers:
               type: array
               items:
                 $ref: '#/components/schemas/microsoft.graph.bookingStaffMember'
+              description: All staff members that provides services in this business.
           description: Represents a Microsot Bookings Business.
       example:
         id: string (identifier)
@@ -2145,18 +2150,23 @@ components:
           nullable: true
         street:
           type: string
+          description: The street.
           nullable: true
         city:
           type: string
+          description: The city.
           nullable: true
         state:
           type: string
+          description: The state.
           nullable: true
         countryOrRegion:
           type: string
+          description: 'The country or region. It''s a free-format string value, for example, ''United States''.'
           nullable: true
         postalCode:
           type: string
+          description: The postal code.
           nullable: true
       example:
         type:
@@ -2220,6 +2230,7 @@ components:
       properties:
         id:
           type: string
+          description: Read-only.
       example:
         id: string (identifier)
     microsoft.graph.location:
@@ -2228,21 +2239,25 @@ components:
       properties:
         displayName:
           type: string
+          description: The name associated with the location.
           nullable: true
         locationEmailAddress:
           type: string
+          description: Optional email address of the location.
           nullable: true
         address:
           $ref: '#/components/schemas/microsoft.graph.physicalAddress'
         coordinates:
           $ref: '#/components/schemas/microsoft.graph.outlookGeoCoordinates'
         locationUri:
           type: string
+          description: Optional URI representing the location.
           nullable: true
         locationType:
           $ref: '#/components/schemas/microsoft.graph.locationType'
         uniqueId:
           type: string
+          description: For internal use only.
           nullable: true
         uniqueIdType:
           $ref: '#/components/schemas/microsoft.graph.locationUniqueIdType'
@@ -2265,8 +2280,10 @@ components:
       properties:
         dateTime:
           type: string
+          description: 'A single point of time in a combined date and time representation ({date}T{time}; for example, 2017-08-29T04:00:00.0000000).'
         timeZone:
           type: string
+          description: 'Represents a time zone, for example, ''Pacific Standard Time''. See below for more possible values.'
           nullable: true
       example:
         dateTime: string
@@ -2382,22 +2399,27 @@ components:
       properties:
         altitude:
           type: number
+          description: The altitude of the location.
           format: double
           nullable: true
         latitude:
           type: number
+          description: The latitude of the location.
           format: double
           nullable: true
         longitude:
           type: number
+          description: The longitude of the location.
           format: double
           nullable: true
         accuracy:
           type: number
+          description: 'The accuracy of the latitude and longitude. As an example, the accuracy can be measured in meters, such as the latitude and longitude are accurate to within 50 meters.'
           format: double
           nullable: true
         altitudeAccuracy:
           type: number
+          description: The accuracy of the altitude.
           format: double
           nullable: true
       example:

openApiDocs/Beta/DevicesApps.MobileAppManagement.yml

@@ -1,9 +1,9 @@
 openapi: 3.0.1
 info:
   title: DevicesApps.MobileAppManagement
-  version: v1.0-Beta
+  version: v1.0-beta
 servers:
-  - url: https://graph.microsoft.com/Beta/
+  - url: https://graph.microsoft.com/beta/
     description: Core
 paths:
   '/users/{user-id}/managedAppRegistrations':
@@ -427,14 +427,17 @@ components:
               type: array
               items:
                 $ref: '#/components/schemas/microsoft.graph.managedAppPolicy'
+              description: Zero or more policys already applied on the registered app when it last synchronized with managment service.
             intendedPolicies:
               type: array
               items:
                 $ref: '#/components/schemas/microsoft.graph.managedAppPolicy'
+              description: Zero or more policies admin intended for the app as of now.
             operations:
               type: array
               items:
                 $ref: '#/components/schemas/microsoft.graph.managedAppOperation'
+              description: Zero or more long running operations triggered on the app registration.
           description: The ManagedAppEntity is the base entity type for all other entity types under app management workflow.
       example:
         id: string (identifier)
@@ -508,6 +511,7 @@ components:
       properties:
         id:
           type: string
+          description: Read-only.
       example:
         id: string (identifier)
     microsoft.graph.managedAppFlaggedReason:

openApiDocs/Beta/DevicesApps.OfficeConfiguration.yml

@@ -1,9 +1,9 @@
 openapi: 3.0.1
 info:
   title: DevicesApps.OfficeConfiguration
-  version: v1.0-Beta
+  version: v1.0-beta
 servers:
-  - url: https://graph.microsoft.com/Beta/
+  - url: https://graph.microsoft.com/beta/
     description: Core
 paths:
   /officeConfiguration:
@@ -606,6 +606,7 @@ components:
       properties:
         id:
           type: string
+          description: Read-only.
       example:
         id: string (identifier)
     microsoft.graph.officeClientCheckinStatus: