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

office365/intune/audit/event.py

@@ -1,30 +1,27 @@
 from office365.entity import Entity
-from office365.entity_collection import EntityCollection
-from office365.runtime.client_result import ClientResult
-from office365.runtime.queries.function import FunctionQuery
-from office365.runtime.types.collections import StringCollection
+from office365.intune.audit.actor import AuditActor
+from office365.intune.audit.resource import AuditResource
+from office365.runtime.client_value_collection import ClientValueCollection
 
 
 class AuditEvent(Entity):
     """A class containing the properties for Audit Event."""
 
-
-class AuditEventCollection(EntityCollection):
-
-    def __init__(self, context, resource_path=None):
-        super(AuditEventCollection, self).__init__(context, AuditEvent, resource_path)
-
-    def get_audit_categories(self):
-        return_type = ClientResult(self.context, StringCollection())
-        qry = FunctionQuery(self, "getAuditCategories", None, return_type)
-        self.context.add_query(qry)
-        return return_type
-
-    def get_audit_activity_types(self, category):
-        """"""
-        return_type = ClientResult(self.context, StringCollection())
-        params = {"category": category}
-        qry = FunctionQuery(self, "getAuditActivityTypes", params, return_type)
-        self.context.add_query(qry)
-        return return_type
-
+    @property
+    def activity(self):
+        """Friendly name of the activity.
+        :rtype: str
+        """
+        return self.properties.get("activity", None)
+
+    @property
+    def actor(self):
+        """
+        AAD user and application that are associated with the audit event.
+        """
+        return self.properties.get("actor", AuditActor())
+
+    @property
+    def resources(self):
+        """Resources being modified"""
+        return self.properties.get("resources", ClientValueCollection(AuditResource))

office365/intune/audit/event_collection.py

@@ -0,0 +1,26 @@
+from office365.entity_collection import EntityCollection
+from office365.intune.audit.event import AuditEvent
+from office365.runtime.client_result import ClientResult
+from office365.runtime.queries.function import FunctionQuery
+from office365.runtime.types.collections import StringCollection
+
+
+class AuditEventCollection(EntityCollection):
+
+    def __init__(self, context, resource_path=None):
+        super(AuditEventCollection, self).__init__(context, AuditEvent, resource_path)
+
+    def get_audit_categories(self):
+        """Not yet documented"""
+        return_type = ClientResult(self.context, StringCollection())
+        qry = FunctionQuery(self, "getAuditCategories", None, return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    def get_audit_activity_types(self, category):
+        """Not yet documented"""
+        return_type = ClientResult(self.context, StringCollection())
+        params = {"category": category}
+        qry = FunctionQuery(self, "getAuditActivityTypes", params, return_type)
+        self.context.add_query(qry)
+        return return_type

office365/intune/audit/property.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class AuditProperty(ClientValue):
+    """A class containing the properties for Audit Property."""

office365/intune/audit/resource.py

@@ -0,0 +1,11 @@
+from office365.runtime.client_value import ClientValue
+
+
+class AuditResource(ClientValue):
+    """A class containing the properties for Audit Resource."""
+
+    def __init__(self, audit_resource_type=None):
+        """
+        :param str audit_resource_type: Audit resource's type.
+        """
+        self.auditResourceType = audit_resource_type

office365/intune/brand.py

@@ -0,0 +1,6 @@
+from office365.runtime.client_value import ClientValue
+
+
+class IntuneBrand(ClientValue):
+    """intuneBrand contains data which is used in customizing the appearance of the Company Portal applications as
+    well as the end user web portal."""

office365/intune/devices/compliance/policy.py

@@ -0,0 +1,6 @@
+from office365.entity import Entity
+
+
+class DeviceCompliancePolicy(Entity):
+    """This is the base class for Compliance policy. Compliance policies are platform specific and individual
+    per-platform compliance policies inherit from here"""

office365/intune/devices/compliance/policy_state.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class DeviceCompliancePolicyState(Entity):
+    """Device Compliance Policy State for a given device"""

office365/intune/devices/data.py

@@ -0,0 +1,5 @@
+from office365.runtime.client_value import ClientValue
+
+
+class DeviceAndAppManagementData(ClientValue):
+    """Exported Data"""

office365/intune/devices/detail.py

@@ -4,3 +4,13 @@ from office365.runtime.client_value import ClientValue
 class DeviceDetail(ClientValue):
     """Indicates device details associated with a device used for signing in. This includes information
     like device browser and operating system, and whether the device is Azure AD managed."""
+
+    def __init__(self, browser=None, device_id=None, display_name=None):
+        """
+        :param str browser: Indicates the browser information of the used for signing in.
+        :param str device_id: Refers to the UniqueID of the device used for signing in.
+        :param str display_name: Refers to the name of the device used for signing in.
+        """
+        self.browser = browser
+        self.deviceId = device_id
+        self.displayName = display_name

office365/intune/devices/enrollment/configuration.py

@@ -0,0 +1,25 @@
+import datetime
+
+from office365.entity import Entity
+
+
+class DeviceEnrollmentConfiguration(Entity):
+    """The Base Class of Device Enrollment Configuration"""
+
+    @property
+    def created_datetime(self):
+        """
+        Created date time in UTC of the device enrollment configuration
+        """
+        return self.properties.get("createdDateTime", datetime.datetime.min)
+
+    @property
+    def display_name(self):
+        """
+        The display name of the device enrollment configuration
+        :rtype: str
+        """
+        return self.properties.get("displayName", None)
+
+    def get_property(self, name, default_value=None):
+        return super(DeviceEnrollmentConfiguration, self).get_property(name, default_value)

office365/intune/devices/enrollment/configuration_assignment.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class EnrollmentConfigurationAssignment(Entity):
+    """Enrollment Configuration Assignment"""

office365/intune/devices/enrollment/limit_configuration.py

@@ -0,0 +1,5 @@
+from office365.intune.devices.enrollment.configuration import DeviceEnrollmentConfiguration
+
+
+class DeviceEnrollmentLimitConfiguration(DeviceEnrollmentConfiguration):
+    """Device Enrollment Configuration that restricts the number of devices a user can enroll"""

office365/intune/devices/managed.py

@@ -1,5 +1,7 @@
 from office365.entity import Entity
+from office365.entity_collection import EntityCollection
 from office365.intune.devices.category import DeviceCategory
+from office365.intune.devices.compliance.policy_state import DeviceCompliancePolicyState
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.service_operation import ServiceOperationQuery
 
@@ -13,11 +15,49 @@ class ManagedDevice(Entity):
         self.context.add_query(qry)
         return self
 
+    @property
+    def activation_lock_bypass_code(self):
+        """
+        The code that allows the Activation Lock on managed device to be bypassed. Default,
+        is Null (Non-Default property) for this property when returned as part of managedDevice entity in LIST call.
+        To retrieve actual values GET call needs to be made, with device id and included in select parameter.
+        Supports: $select. $Search is not supported. Read-only. This property is read-only.
+        :rtype: str
+        """
+        return self.properties.get("activationLockBypassCode", None)
+
     @property
     def device_category(self):
         """	Device category"""
-        return self.properties.get('deviceCategory', DeviceCategory(self.context,
-                                                                    ResourcePath("deviceCategory", self.resource_path)))
+        return self.properties.get('deviceCategory',
+                                   DeviceCategory(self.context,
+                                                  ResourcePath("deviceCategory", self.resource_path)))
+
+    @property
+    def manufacturer(self):
+        """
+        Manufacturer of the device.
+        :rtype: str
+        """
+        return self.properties.get("manufacturer", None)
+
+    @property
+    def operating_system(self):
+        """
+        Manufacturer of the device.
+        :rtype: str
+        """
+        return self.properties.get("operatingSystem", None)
+
+    @property
+    def device_compliance_policy_states(self):
+        """
+        Device compliance policy states for this device
+        """
+        return self.properties.get('deviceCompliancePolicyStates',
+                                   EntityCollection(self.context, DeviceCompliancePolicyState,
+                                                    ResourcePath("deviceCompliancePolicyStates",
+                                                                 self.resource_path)))
 
     @property
     def users(self):
@@ -28,7 +68,8 @@ class ManagedDevice(Entity):
     def get_property(self, name, default_value=None):
         if default_value is None:
             property_mapping = {
-                "deviceCategory": self.device_category
+                "deviceCategory": self.device_category,
+                "deviceCompliancePolicyStates": self.device_compliance_policy_states
             }
             default_value = property_mapping.get(name, None)
         return super(ManagedDevice, self).get_property(name, default_value)

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/announcement.py

@@ -0,0 +1,39 @@
+from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.intune.servicecommunications.health.health import ServiceHealth
+from office365.intune.servicecommunications.issues.issue import ServiceHealthIssue
+from office365.intune.servicecommunications.messages.update import ServiceUpdateMessage
+from office365.runtime.paths.resource_path import ResourcePath
+
+
+class ServiceAnnouncement(Entity):
+    """A top-level container for service communications resources."""
+
+    @property
+    def health_overviews(self):
+        """Get the serviceHealth resources from the healthOverviews navigation property."""
+        return self.properties.get('healthOverviews',
+                                   EntityCollection(self.context, ServiceHealth,
+                                                    ResourcePath("healthOverviews", self.resource_path)))
+
+    @property
+    def issues(self):
+        """Get the serviceHealthIssue resources from the issues navigation property."""
+        return self.properties.get('issues',
+                                   EntityCollection(self.context, ServiceHealthIssue,
+                                                    ResourcePath("issues", self.resource_path)))
+
+    @property
+    def messages(self):
+        """Get the serviceUpdateMessage resources from the messages navigation property."""
+        return self.properties.get('messages',
+                                   EntityCollection(self.context, ServiceUpdateMessage,
+                                                    ResourcePath("messages", self.resource_path)))
+
+    def get_property(self, name, default_value=None):
+        if default_value is None:
+            property_mapping = {
+                "healthOverviews": self.health_overviews
+            }
+            default_value = property_mapping.get(name, None)
+        return super(ServiceAnnouncement, self).get_property(name, default_value)

office365/intune/servicecommunications/announcement_base.py

@@ -0,0 +1,5 @@
+from office365.entity import Entity
+
+
+class ServiceAnnouncementBase(Entity):
+    """This is an abstract base type for serviceHealthIssue and serviceUpdateMessage."""

office365/intune/servicecommunications/health/health.py

@@ -0,0 +1,7 @@
+from office365.entity import Entity
+
+
+class ServiceHealth(Entity):
+    """Represents the health information of a service subscribed by a tenant."""
+
+

office365/intune/servicecommunications/issues/issue.py

@@ -0,0 +1,29 @@
+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):
+    """
+    Represents a service health issue in a service.
+
+    The service health issue can be a service incident or service advisory. For example:
+
+       - Service incident: "Exchange mailbox service is down".
+       - 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
+
+