Перемещаем информацию о пользователях в Active Directory и Sharepoint c помощью PowerShell

##################################################################################

param([string]$path, [string]$url,[string]$ou,[switch]$help)

[void][System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SharePoint")


#функция помощи

function GetHelp() {


$HelpText = @"

Описание:

Данный скрипт используется для актуализации данных списка пользователей.
Предварительно данные из ActiveDirectory должны быть экспортированы в *.csv файл.
Из csv файла в список SharePoint'а забираются следующие столбцы:
* sn              - Фамилия
* givenName       - Имя
* DisplayName     - Полное имя (Ф.И.О.)
* mail            - E-mail адрес
* LogonName       - Логин
* telephoneNumber - Телефонный номер ВТС
* Office          - Кабинет
* Department      - Отдел
* Title           - Должность
* HomePhone       - Домашний телефон (в нашем случае Городсокй телефон )
* MobilePhone     - Телефонный номер мобильный
--------------------------------------------------------------------------------
Параметры: 
-path		Путь расположения csv файла, откуда будут импортироваться данные
-url		http путь расположения конечного списка, куда будут импортироваться данные
-ou         Указать Organization unit в AD, откуда будут импортироваться пользователи, 
например: OU=accaunts- загрузяться все пользователи.
OU=cometa - загрузяться только пользователи филиала
--------------------------------------------------------------------------------
Синтаксис:

Запуск скрипта из PowerShell:
.\ImportADUsersToSPList.ps1 -path "Your path" -url "List URL" -ou "OU=cometa"

Вызов справки:
.\ImportADUsersToSPList.ps1 -help

--------------------------------------------------------------------------------
Синтаксис:

Запуск скрипта из командной строки Windows:
powershell .\ImportADUsersToSPList.ps1 -path "Your path" -url "List URL" -ou "OU=Magadan"

Вызов справки:
powershell .\ImportADUsersToSPList.ps1 -help
--------------------------------------------------------------------------------
"@
$HelpText

}

function nz($value)
{	if ($value -eq $null) {
		$value=""
	} 
return $value
}

function UpdateList([string]$path,[string]$url,[string]$ou) 
{
#Загружаем необхоимые данные и вводим переменные:
$site=New-Object Microsoft.SharePoint.SPSite($url)
$web=$site.OpenWeb()
$list=$web.GetList($url)
$csv_file=Import-Csv -Delimiter ";" $path
$listItems=$list.Items
$spFiledType=[Microsoft.SharePoint.SPFieldType]::Text

######################################################### 
#В цикле проверяем каждую строку csv файла и заносим данные в список:
#пишем  лог:
"Script started at:" | Out-File -encoding default ".\UpdateUsers.log" -Append
Get-Date | Out-File -encoding default ".\UpdateUsers.log" -Append
	foreach ($line in $csv_file) {
		$update=$false
        if (!($item=$list.Items | where {$_["Sid"] -eq $line.Sid})) {

			#убираем служебные учетные записи
			if (!(select-string -pattern "88" -inputobject $line.givenName) -and (!(select-string -pattern "Admin" -inputobject $line.givenName)) -and (!(select-string -pattern "Operator" -inputobject $line.givenName))-and ((select-string -pattern $ou -inputobject $line.DN)))
			{	Write-Output $line
				$item=$list.Items.Add()
				$item["Sid"]=$line.Sid
                $update=$true
			} else {continue}
		}
        [array]$sids+=$line.Sid        
		$t=$line.DisplayName -split " ",3
        if ((nz($item["Фамилия"])) -ne (nz($t[0])))
            {
             $item["Фамилия"]=$t[0]
             $update=$true
             }
		if ((nz($item["Имя"])) -ne (nz($t[1])))
            { $item["Имя"]=$t[1]
            $update=$true
            }
		
		if ((nz($item["Отчество"])) -ne (nz($t[2])))
            { $item["Отчество"]=$t[2]
            $update=$true
            }
            $tfioname=$t[1] -split "",3 
		    $tfioMidName=$t[2] -split "",3
		    $fio=$t[0]+" "+$tfioname[1]+"."+$tfioMidName[1]+"."
	if ((nz($item["Ф.И.О."])) -ne (nz($fio)))
            { $item["Ф.И.О."]=$fio
            $update=$true
            }
		$fio=$tfioname[1]+"."+$tfioMidName[1]+". "+$t[0]
	if ((nz($item["И.О.Ф."])) -ne (nz($fio)))
            { $item["И.О.Ф."]=$fio
            $update=$true
            }
		if ((nz($item["E-mail"])) -ne (nz($line.mail)))
            { $item["E-mail"]=$line.mail
            $update=$true
            }
		if ((nz($item["Логин"])) -ne (nz($line.LogonName)))
            { $item["Логин"]=$line.LogonName
             $update=$true
            }
		if ((nz($item["ВТС"])) -ne (nz($line.telephoneNumber)))
            { $item["ВТС"]=$line.telephoneNumber 
            $update=$true
            }
		if ((nz($item["Кабинет"])) -ne (nz($line.Office)))
        	{ $item["Кабинет"]=$line.Office 
            $update=$true
            }
		if ((nz($item["Отдел"])) -ne (nz($line.Department)))
            { $item["Отдел"]=$line.Department 
            $update=$true
            }
		if ((nz($item["Должность"])) -ne (nz($line.Title)))
            { $item["Должность"]=$line.Title 
            $update=$true
            }
		if ((nz($item["ГТС"])) -ne (nz($line.HomePhone)))
            { $item["ГТС"]=$line.HomePhone 
            $update=$true
            }
		if ((nz($item["DECT"])) -ne (nz($line.MobilePhone)))
            { $item["DECT"]=$line.MobilePhone 
            $update=$true
            }
		if ($update -eq $true) 
          {
         $item.Update()
 
          }
	}
   
$listItems=$list.Items

    for ($x=$listItems.Count-1; $x -ge 0; $x--) 
        {
        if (($sids | where {$_ -eq $listItems[$x]["Sid"] }) -eq $null)
            {
            $notify="Удален пользователь: "+ $listItems[$x]["Фамилия"].ToString()
            $notify | Out-File -encoding default ".\UpdateGUUsers.log" -Append
            $listItems[$x].Recycle()
            }
        }
"Script finished at:" | Out-File -encoding default ".\UpdateGUUsers.log" -Append        
Get-Date | Out-File -encoding default ".\UpdateGUUsers.log" -Append
"______________________________" | Out-File -encoding default ".\UpdateGUUsers.log" -Append       

$site.Dispose()        
}

if($help) { GetHelp; Continue }
if($path -AND $url -AND $ou) { UpdateList -path $path -url $url -ou $ou}