drive Property
Selects a drive.
Syntax
def get_drive() -> str: ... def set_drive(value: str) -> None: ...
drive = property(get_drive, set_drive)
Default Value
""
Remarks
This property can be set to the Id of a specific drive to select it for use.
When this property is empty (default), the class uses the following logic to determine which drive to select:
- If the GroupId and SiteId configuration settings are both empty (also default), the current user's default drive is used.
- Otherwise, if the GroupId configuration setting is populated, that group's default drive is used.
- Otherwise, if the SiteId configuration setting is populated, that site's default drive is used.
Note: For use-cases that only make use of the current user's default drive (e.g., when authenticated with a personal Microsoft account), there is no need to ever call list_drives, set the drive property, or use any of the class's other drive-related API members. By default, the drive property and the GroupId and SiteId configuration settings are all empty, which causes the class to use the current user's default drive.