Office365-REST-Python-Client 2.4.3__py3-none-any.whl → 2.4.4__py3-none-any.whl

office365/intune/devices/management/management.py

@@ -0,0 +1,69 @@
+from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.intune.audit.event_collection import AuditEventCollection
+from office365.intune.brand import IntuneBrand
+from office365.intune.devices.category import DeviceCategory
+from office365.intune.devices.enrollment.configuration import DeviceEnrollmentConfiguration
+from office365.intune.devices.managed import ManagedDevice
+from office365.intune.devices.management.reports.reports import DeviceManagementReports
+from office365.runtime.paths.resource_path import ResourcePath
+
+
+class DeviceManagement(Entity):
+    """
+    The deviceManagement resource represents a tenant's collection device identities that have been pre-staged in
+    Intune, and the enrollment profiles that may be assigned to device identities that support pre-enrollment
+    configuration.
+    """
+
+    @property
+    def audit_events(self):
+        """"""
+        return self.properties.get("auditEvents", AuditEventCollection(self.context,
+                                                                       ResourcePath("auditEvents",
+                                                                                    self.resource_path)))
+
+    @property
+    def device_categories(self):
+        """"""
+        return self.properties.get("deviceCategories",
+                                   EntityCollection(self.context, DeviceCategory, ResourcePath("deviceCategories",
+                                                                                               self.resource_path)))
+
+    @property
+    def device_enrollment_configurations(self):
+        """"""
+        return self.properties.get('deviceEnrollmentConfigurations',
+                                   EntityCollection(self.context, DeviceEnrollmentConfiguration,
+                                                    ResourcePath("deviceEnrollmentConfigurations",
+                                                                 self.resource_path)))
+
+    @property
+    def intune_brand(self):
+        return self.properties.get("intuneBrand", IntuneBrand())
+
+    @property
+    def managed_devices(self):
+        """"""
+        return self.properties.get('managedDevices',
+                                   EntityCollection(self.context, ManagedDevice,
+                                                    ResourcePath("managedDevices", self.resource_path)))
+
+    @property
+    def reports(self):
+        """"""
+        return self.properties.get("reports",
+                                   DeviceManagementReports(self.context,
+                                                           ResourcePath("reports", self.resource_path)))
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "auditEvents": self.audit_events,
+                "deviceCategories": self.device_categories,
+                "deviceEnrollmentConfigurations": self.device_enrollment_configurations,
+                "intuneBrand": self.intune_brand,
+                "managedDevices": self.managed_devices
+            }
+            default_value = property_mapping.get(name, None)
+        return super(DeviceManagement, self).get_property(name, default_value)

office365/intune/devices/management/reports/reports.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class DeviceManagementReports(Entity):
+    """Device management reports entity"""

office365/intune/devices/management/settings.py

@@ -0,0 +1,18 @@
+from office365.runtime.client_value import ClientValue
+
+
+class DeviceManagementSettings(ClientValue):
+    """"""
+
+    def __init__(self, device_compliance_checkin_threshold_days=None, is_scheduled_action_enabled=None,
+                 secure_by_default=None):
+        """
+        :param int device_compliance_checkin_threshold_days: The number of days a device is allowed to go without
+            checking in to remain compliant.
+        :param bool is_scheduled_action_enabled: Is feature enabled or not for scheduled action for rule.
+        :param bool secure_by_default: Device should be noncompliant when there is no compliance policy targeted when
+            this is true
+        """
+        self.deviceComplianceCheckinThresholdDays = device_compliance_checkin_threshold_days
+        self.isScheduledActionEnabled = is_scheduled_action_enabled
+        self.secureByDefault = secure_by_default

office365/intune/organizations/branding.py

@@ -0,0 +1,15 @@
+from office365.intune.organizations.branding_properties import OrganizationalBrandingProperties
+
+
+class OrganizationalBranding(OrganizationalBrandingProperties):
+    """
+    Contains details about the organization's default branding. Inherits from organizationalBrandingProperties.
+
+    Organizations can customize their Azure Active Directory (Azure AD) sign-in pages which appear when users sign
+    in to their organization's tenant-specific apps, or when Azure AD identifies the user's tenant from their username.
+    A developer can also read the company's branding information and customize their app experience to tailor
+    it specifically for the signed-in user using their company's branding.
+
+    You can't change your original configuration's language. However, companies can add different branding based on
+    locale. For language-specific branding, see the organizationalBrandingLocalization object.
+    """

office365/intune/organizations/organization.py

@@ -1,8 +1,10 @@
 from office365.directory.certificates.auth_configuration import CertificateBasedAuthConfiguration
 from office365.directory.domains.verified import VerifiedDomain
+from office365.directory.licenses.assigned_plan import AssignedPlan
 from office365.directory.object import DirectoryObject
 from office365.directory.extensions.extension import Extension
 from office365.entity_collection import EntityCollection
+from office365.intune.organizations.branding import OrganizationalBranding
 from office365.intune.provisioned_plan import ProvisionedPlan
 from office365.runtime.client_value_collection import ClientValueCollection
 from office365.runtime.paths.resource_path import ResourcePath
@@ -15,6 +17,17 @@ class Organization(DirectoryObject):
     which operate and are provisioned at the tenant-level.
     """
 
+    @property
+    def assigned_plans(self):
+        """The plans that are assigned to the organization."""
+        return self.properties.get('assignedPlans', ClientValueCollection(AssignedPlan))
+
+    @property
+    def branding(self):
+        return self.properties.get('branding',
+                                   OrganizationalBranding(self.context,
+                                                          ResourcePath("branding", self.resource_path)))
+
     @property
     def business_phones(self):
         """
@@ -51,6 +64,7 @@ class Organization(DirectoryObject):
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
+                "assignedPlans": self.assigned_plans,
                 "certificateBasedAuthConfiguration": self.certificate_based_auth_configuration,
                 "businessPhones": self.business_phones,
                 "provisionedPlans": self.provisioned_plans,

office365/intune/printing/base.py

@@ -0,0 +1,11 @@
+from office365.entity import Entity
+from office365.intune.printing.capabilities import PrinterCapabilities
+
+
+class PrinterBase(Entity):
+    """Represents a base type for printer and printerShare entity types."""
+
+    @property
+    def capabilities(self):
+        """The capabilities of the printer/printerShare."""
+        return self.properties.get("", PrinterCapabilities())

office365/intune/printing/capabilities.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class PrinterCapabilities(ClientValue):
+    """Represents the capabilities reported by a printer/printerShare."""

office365/intune/printing/connectors/connector.py

@@ -0,0 +1,6 @@
+from office365.entity import Entity
+
+
+class PrintConnector(Entity):
+    """Represents a print connector that has been registered by using a Universal Print subscription.
+    The printConnector resource can be used to view connector status and update properties."""

office365/intune/printing/print.py

@@ -0,0 +1,24 @@
+from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.intune.printing.connectors.connector import PrintConnector
+from office365.intune.printing.share import PrinterShare
+from office365.runtime.paths.resource_path import ResourcePath
+
+
+class Print(Entity):
+    """When accompanied by a Universal Print subscription, the Print feature enables management of printers and
+    discovery of printServiceEndpoints that can be used to manage printers and print jobs within Universal Print."""
+
+    @property
+    def connectors(self):
+        """The list of available print connectors."""
+        return self.properties.get('connectors',
+                                   EntityCollection(self.context, PrintConnector,
+                                                    ResourcePath("connectors", self.resource_path)))
+
+    @property
+    def shares(self):
+        """The list of printer shares registered in the tenant."""
+        return self.properties.get('shares',
+                                   EntityCollection(self.context, PrinterShare,
+                                                    ResourcePath("shares", self.resource_path)))

office365/intune/printing/printer.py

@@ -0,0 +1,6 @@
+from office365.intune.printing.base import PrinterBase
+
+
+class Printer(PrinterBase):
+    """Represents a printer device that has been registered with the Universal Print service.
+    Printer resources can be used to manage print jobs, printer settings, printer metadata and registration status."""

office365/intune/printing/services/endpoint.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class PrintServiceEndpoint(Entity):
+    """Represents URI and identifying information for a print service instance."""

office365/intune/printing/services/service.py

@@ -0,0 +1,17 @@
+from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.intune.printing.services.endpoint import PrintServiceEndpoint
+from office365.runtime.paths.resource_path import ResourcePath
+
+
+class PrintService(Entity):
+    """Represents an Azure AD tenant-specific description of a print service instance.
+    Services exist for each component of the printing infrastructure (discovery, notifications, registration, and IPP)
+    and have one or more endpoints."""
+
+    def endpoints(self):
+        """Endpoints that can be used to access the service."""
+        return self.properties.get('endpoints',
+                                   EntityCollection(self.context, PrintServiceEndpoint,
+                                                    ResourcePath("endpoints", self.resource_path)))
+

office365/intune/printing/share.py

@@ -0,0 +1,5 @@
+from office365.intune.printing.base import PrinterBase
+
+
+class PrinterShare(PrinterBase):
+    """Represents a printer that is intended to be discoverable by users and printing applications."""

office365/intune/provisioned_plan.py

@@ -6,11 +6,15 @@ class ProvisionedPlan(ClientValue):
     The provisionedPlans property of the user entity and the organization entity is a collection of provisionedPlan.
     """
 
-    def __init__(self, service=None):
+    def __init__(self, service=None, provisioning_status=None, capability_status=None):
         """
         :param str service:
+        :param str provisioning_status:
+        :param str capability_status:
         """
         self.service = service
+        self.provisioningStatus = provisioning_status
+        self.capabilityStatus = capability_status
 
     def __repr__(self):
         return self.service

office365/intune/servicecommunications/issues/issue.py

@@ -1,4 +1,6 @@
 from office365.intune.servicecommunications.announcement_base import ServiceAnnouncementBase
+from office365.runtime.client_result import ClientResult
+from office365.runtime.queries.function import FunctionQuery
 
 
 class ServiceHealthIssue(ServiceAnnouncementBase):
@@ -11,4 +13,17 @@ class ServiceHealthIssue(ServiceAnnouncementBase):
        - Service advisory: "Users may experience delays in emails reception".
     """
 
+    def incident_report(self):
+        """
+        Provide the Post-Incident Review (PIR) document of a specified service issue for tenant.
+
+        An issue only with status of PostIncidentReviewPublished indicates that the PIR document exists for the issue.
+        The operation returns an error if the specified issue doesn't exist for the tenant or if PIR document
+        does not exist for the issue.
+        """
+        return_type = ClientResult(self.context, bytes())
+        qry = FunctionQuery(self, "incidentReport", None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
 

office365/intune/vpp_token.py

@@ -0,0 +1,10 @@
+from office365.entity import Entity
+
+
+class VppToken(Entity):
+    """
+    You purchase multiple licenses for iOS apps through the Apple Volume Purchase Program for Business or Education.
+    This involves setting up an Apple VPP account from the Apple website and uploading the Apple VPP Business or
+    Education token to Intune. You can then synchronize your volume purchase information with Intune and track your
+    volume-purchased app use. You can upload multiple Apple VPP Business or Education tokens.
+    """

office365/onedrive/columns/content_approval_status.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class ContentApprovalStatusColumn(ClientValue):
+    """Represents a content approval status column in SharePoint."""

office365/onedrive/columns/datetime.py

@@ -0,0 +1,15 @@
+from office365.runtime.client_value import ClientValue
+
+
+class DateTimeColumn(ClientValue):
+    """The dateTimeColumn on a columnDefinition resource indicates that the column's values are dates or times."""
+
+    def __init__(self, display_as=None, display_format=None):
+        """
+        :param str display_as: How the value should be presented in the UX. Must be one of default, friendly,
+             or standard. See below for more details. If unspecified, treated as default.
+        :param str display_format: Indicates whether the value should be presented as a date only or a date and time.
+            Must be one of dateOnly or dateTime
+        """
+        self.displayAs = display_as
+        self.format = display_format

office365/onedrive/columns/definition.py

@@ -2,6 +2,9 @@ from office365.base_item import BaseItem
 from office365.onedrive.columns.boolean import BooleanColumn
 from office365.onedrive.columns.calculated import CalculatedColumn
 from office365.onedrive.columns.choice import ChoiceColumn
+from office365.onedrive.columns.content_approval_status import ContentApprovalStatusColumn
+from office365.onedrive.columns.currency import CurrencyColumn
+from office365.onedrive.columns.datetime import DateTimeColumn
 from office365.onedrive.columns.default_value import DefaultColumnValue
 from office365.onedrive.columns.geolocation import GeolocationColumn
 from office365.onedrive.columns.hyperlink_or_picture import HyperlinkOrPictureColumn
@@ -47,6 +50,11 @@ class ColumnDefinition(BaseItem):
         """Specifies whether the column values can used for sorting and searching."""
         return self.properties.get('indexed', None)
 
+    @property
+    def content_approval_status(self):
+        """This column stores content approval status."""
+        return self.properties.get('contentApprovalStatus', ContentApprovalStatusColumn())
+
     @property
     def column_group(self):
         """For site columns, the name of the group this column belongs to. Helps organize related columns."""
@@ -72,6 +80,16 @@ class ColumnDefinition(BaseItem):
         """This column stores data from a list of choices."""
         return self.properties.get('choice', ChoiceColumn())
 
+    @property
+    def currency(self):
+        """This column stores currency values."""
+        return self.properties.get('currency', CurrencyColumn())
+
+    @property
+    def datetime(self):
+        """This column stores DateTime values."""
+        return self.properties.get('dateTime', DateTimeColumn())
+
     @property
     def person_or_group(self):
         """This column stores Person or Group values."""
@@ -107,18 +125,31 @@ class ColumnDefinition(BaseItem):
         """This column stores hyperlink or picture values."""
         return self.properties.get('hyperlinkOrPicture', HyperlinkOrPictureColumn())
 
+    @property
+    def hidden(self):
+        """Specifies whether the column is displayed in the user interface.
+        :rtype: bool or None
+        """
+        return self.properties.get('hidden', None)
+
     @property
     def is_deletable(self):
         """Indicates whether this column can be deleted.
-
         :rtype: bool or None
         """
         return self.properties.get('isDeletable', None)
 
+    @property
+    def is_reorderable(self):
+        """
+        Indicates whether values in the column can be reordered. Read-only.
+        :rtype: bool or None
+        """
+        return self.properties.get('isReorderable', None)
+
     @property
     def is_sealed(self):
         """Specifies whether the column can be changed.
-
         :rtype: bool or None
         """
         return self.properties.get('isSealed', None)
@@ -126,11 +157,17 @@ class ColumnDefinition(BaseItem):
     @property
     def propagate_changes(self):
         """If 'true', changes to this column will be propagated to lists that implement the column.
-
         :rtype: bool or None
         """
         return self.properties.get('propagateChanges', None)
 
+    @property
+    def read_only(self):
+        """Specifies whether the column values can be modified.
+        :rtype: bool or None
+        """
+        return self.properties.get('readOnly', None)
+
     @property
     def thumbnail(self):
         """This column stores thumbnail values."""
@@ -151,9 +188,18 @@ class ColumnDefinition(BaseItem):
         """This column stores taxonomy terms."""
         return self.properties.get('term', TermColumn())
 
+    @property
+    def type(self):
+        """
+        For site columns, the type of column.
+        :rtype: str
+        """
+        return self.properties.get('type', None)
+
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
+                "contentApprovalStatus": self.content_approval_status,
                 "defaultValue": self.default_value,
                 "hyperlinkOrPicture": self.hyperlink_or_picture,
                 "personOrGroup": self.person_or_group,

office365/onedrive/columns/definition_collection.py

@@ -8,6 +8,17 @@ class ColumnDefinitionCollection(EntityCollection):
     def __init__(self, context, resource_path, parent):
         super(ColumnDefinitionCollection, self).__init__(context, ColumnDefinition, resource_path, parent)
 
+    def add_number(self, name, minimum=None, maximum=None):
+        """
+        Creates a number column
+        :param str name: The API-facing name of the column as it appears in the fields on a listItem
+        :param float minimum: The minimum permitted value.
+        :param float maximum: The maximum permitted value.
+        :rtype: ColumnDefinition
+        """
+        from office365.onedrive.columns.number import NumberColumn
+        return self.add(name=name, number=NumberColumn(minimum, maximum))
+
     def add_text(self, name, max_length=None, text_type=None):
         """
         Creates a text column
@@ -30,27 +41,27 @@ class ColumnDefinitionCollection(EntityCollection):
         from office365.onedrive.columns.hyperlink_or_picture import HyperlinkOrPictureColumn
         return self.add(name=name, hyperlinkOrPicture=HyperlinkOrPictureColumn(is_picture=is_picture))
 
-    def add_lookup(self, name, list_or_id, column_name=None):
+    def add_lookup(self, name, lookup_list, column_name=None):
         """
         Creates a lookup column
 
         :param str name: The API-facing name of the column as it appears in the fields on a listItem
-        :param office365.onedrive.lists.list.List or str list_or_id: Lookup source list or identifier
+        :param office365.onedrive.lists.list.List or str lookup_list: Lookup source list or identifier
         :param str column_name: The name of the lookup source column.
         :rtype: ColumnDefinition
         """
         from office365.onedrive.columns.lookup import LookupColumn
         from office365.onedrive.lists.list import List
 
-        if isinstance(list_or_id, List):
+        if isinstance(lookup_list, List):
             return_type = ColumnDefinition(self.context)
             self.add_child(return_type)
 
             def _list_loaded():
-                params = {"name": name, "lookup": LookupColumn(list_or_id.id, column_name)}
+                params = {"name": name, "lookup": LookupColumn(lookup_list.id, column_name)}
                 qry = CreateEntityQuery(self, params, return_type)
                 self.context.add_query(qry)
-            list_or_id.ensure_property("id", _list_loaded)
+            lookup_list.ensure_property("id", _list_loaded)
             return return_type
         else:
-            return self.add(name=name, lookup=LookupColumn(list_or_id, column_name))
+            return self.add(name=name, lookup=LookupColumn(lookup_list, column_name))

office365/onedrive/columns/types.py

@@ -2,3 +2,16 @@ class ColumnTypes:
 
     text = "text"
     """Single line text."""
+
+    note = "note"
+    """Multiline text."""
+
+    choice = "choice"
+    """Choice column"""
+
+    multichoice = "multichoice"
+    """Multichoice column."""
+
+
+
+

office365/onedrive/driveitems/audio.py

@@ -8,4 +8,15 @@ class Audio(ClientValue):
     If a DriveItem has a non-null audio facet, the item represents an audio file.
     The properties of the Audio resource are populated by extracting metadata from the file.
     """
-    pass
+
+    def __init__(self, album=None, album_artist=None, artist=None, bitrate=None):
+        """
+        :param str album: The title of the album for this audio file.
+        :param str album_artist: The artist named on the album for the audio file.
+        :param str artist: The performing artist for the audio file.
+        :param long bitrate: Bitrate expressed in kbps.
+        """
+        self.album = album
+        self.albumArtist = album_artist
+        self.artist = artist
+        self.bitrate = bitrate