Get Time zones (for schedules)

Author: rusanu

UiPath.PowerShell/Cmdlets/GetTimeZones.cs

@@ -0,0 +1,23 @@
+using System.Management.Automation;
+using UiPath.PowerShell.Models;
+using UiPath.PowerShell.Util;
+using UiPath.Web.Client;
+
+namespace UiPath.PowerShell.Cmdlets
+{
+    /// <summary>
+    /// <para type="synopsis">Shows the valid time zone names recognized by the Orchestrator.</para>
+    /// </summary>
+    [Cmdlet(VerbsCommon.Get, Nouns.TimeZones)]
+    public class GetTimeZones : AuthenticatedCmdlet
+    {
+        protected override void ProcessRecord()
+        {
+            var timeZones = HandleHttpOperationException(() => Api.Settings.GetTimezones());
+            foreach(var tz in timeZones.Items)
+            {
+                WriteObject(Timezone.FromDto(tz));
+            }
+        }
+    }
+}

UiPath.PowerShell/Cmdlets/Nouns.cs

@@ -22,6 +22,7 @@ internal static class Nouns
         internal const string QueueDefinition = UiPath + "QueueDefinition";
         internal const string QueueItem = UiPath + "QueuItem";
         internal const string Tenant = UiPath + "Tenant";
+        internal const string TimeZones = UiPath + "TimeZones";
         internal const string User = UiPath + "User";
     }
 }

UiPath.PowerShell/Models/Timezone.cs

@@ -0,0 +1,19 @@
+using UiPath.Web.Client.Models;
+
+namespace UiPath.PowerShell.Models
+{
+    public class Timezone
+    {
+        public string Name { get; internal set; }
+        public string Value { get; internal set; }
+
+        internal static Timezone FromDto(NameValueDto dto)
+        {
+            return new Timezone
+            {
+                Name = dto.Name,
+                Value = dto.Value
+            };
+        }
+    }
+}

UiPath.PowerShell/UiPath.PowerShell.csproj

@@ -80,6 +80,7 @@
     <Compile Include="Cmdlets\GetPermission.cs" />
     <Compile Include="Cmdlets\GetRole.cs" />
     <Compile Include="Cmdlets\GetProcessSchedule.cs" />
+    <Compile Include="Cmdlets\GetTimeZones.cs" />
     <Compile Include="Cmdlets\GrantRolePermission.cs" />
     <Compile Include="Cmdlets\RemoveAsset.cs" />
     <Compile Include="Cmdlets\GetAsset.cs" />
@@ -114,6 +115,7 @@
     <Compile Include="Models\Role.cs" />
     <Compile Include="Cmdlets\RevokeRolePermission.cs" />
     <Compile Include="Models\ProcessSchedule.cs" />
+    <Compile Include="Models\Timezone.cs" />
     <Compile Include="Util\AuthenticatedCmdlet.cs" />
     <Compile Include="Util\FilterAttribute.cs" />
     <Compile Include="Util\FilteredBaseCmdlet.cs" />

docs/Get-UiPathTimeZones.md

@@ -0,0 +1,26 @@
+```PowerShell
+
+NAME
+    Get-UiPathTimeZones
+    
+SYNOPSIS
+    Shows the valid time zone names recognized by the Orchestrator.
+    
+    
+SYNTAX
+    Get-UiPathTimeZones [-AuthToken <AuthToken>] [<CommonParameters>]
+    
+    
+DESCRIPTION
+    
+
+RELATED LINKS
+
+REMARKS
+    To see the examples, type: "get-help Get-UiPathTimeZones -examples".
+    For more information, type: "get-help Get-UiPathTimeZones -detailed".
+    For technical information, type: "get-help Get-UiPathTimeZones -full".
+
+
+
+```

docs/Home.md

@@ -26,6 +26,7 @@
 - [Get-UiPathRobot](Get-UiPathRobot.md)
 - [Get-UiPathRole](Get-UiPathRole.md)
 - [Get-UiPathTenant](Get-UiPathTenant.md)
+- [Get-UiPathTimeZones](Get-UiPathTimeZones.md)
 - [Get-UiPathUser](Get-UiPathUser.md)
 - [Grant-UiPathRolePermission](Grant-UiPathRolePermission.md)
 - [Register-UiPathLicense](Register-UiPathLicense.md)