Implement Get-Group advanced function

2020-09-29 16:01:37 +03:00
parent 48df3710fd
commit 0cf0626f4c
13 changed files with 290 additions and 59 deletions
--- a/Modules/VMware.vSphere.SsoAdmin/VMware.vSphere.SsoAdmin.psm1
+++ b/Modules/VMware.vSphere.SsoAdmin/VMware.vSphere.SsoAdmin.psm1
@@ -478,4 +478,99 @@ function Remove-PersonUser {
      }
   }
 }
+#endregion
+
+#region Group cmdlets
+function Get-Group {
+<#
+   .NOTES
+   ===========================================================================
+   Created on:   	9/29/2020
+   Created by:   	Dimitar Milov
+    Twitter:       @dimitar_milov
+    Github:        https://github.com/dmilov
+   ===========================================================================
+   .DESCRIPTION
+   This function gets domain groups.
+
+   .PARAMETER Name
+   Specifies Name to filter on when searching for groups.
+
+   .PARAMETER Domain
+   Specifies the Domain in which search will be applied, default is 'localos'.
+
+
+   .PARAMETER Server
+   Specifies the vSphere Sso Admin Server on which you want to run the cmdlet.
+   If not specified the servers available in $global:DefaultSsoAdminServers variable will be used.
+
+   .EXAMPLE
+   Get-Group -Name administrators -Domain vsphere.local
+
+   Gets 'adminsitrators' group in 'vsphere.local' domain
+#>
+[CmdletBinding()]
+ param(
+   [Parameter(
+      Mandatory=$false,
+      ValueFromPipeline=$false,
+      ValueFromPipelineByPropertyName=$false,
+      HelpMessage='Name filter to be applied when searching for group')]
+   [string]
+   $Name,
+
+   [Parameter(
+      Mandatory=$false,
+      ValueFromPipeline=$false,
+      ValueFromPipelineByPropertyName=$false,
+      HelpMessage='Domain name to search in, default is "localos"')]
+   [string]
+   $Domain = 'localos',
+
+   [Parameter(
+      Mandatory=$false,
+      ValueFromPipeline=$false,
+      ValueFromPipelineByPropertyName=$false,
+      HelpMessage='Connected SsoAdminServer object')]
+   [ValidateNotNull()]
+   [VMware.vSphere.SsoAdminClient.DataTypes.SsoAdminServer]
+   $Server)
+
+   Process {
+      $serversToProcess = $global:DefaultSsoAdminServers
+      if ($Server -ne $null) {
+         $serversToProcess = $Server
+      }
+
+      if ($Name -eq $null) {
+         $Name = [string]::Empty
+      }
+
+      foreach ($connection in $serversToProcess) {
+         if (-not $connection.IsConnected) {
+            Write-Error "Server $connection is disconnected"
+            continue
+         }
+
+         foreach ($group in $connection.Client.GetGroups(
+            (RemoveWildcardSymbols $Name),
+            $Domain)) {
+
+
+            if ([string]::IsNullOrEmpty($Name) ) {
+               Write-Output $group
+            } else {
+               # Apply Name filtering
+               if ((HasWildcardSymbols $Name) -and `
+                   $group.Name -like $Name) {
+                   Write-Output $group
+               } elseif ($group.Name -eq $Name) {
+                  # Exactly equal
+                  Write-Output $group
+               }
+            }
+         }
+      }
+   }
+}
 #endregion