Напиши инструкцию для пользователя, что делает скрипт и как им пользоваться: Загрузка…
- User
Напиши инструкцию для пользователя, что делает скрипт и как им пользоваться:
Загрузка необходимых сборок
Add-Type -AssemblyName System.Windows.Forms Add-Type -AssemblyName System.Drawing
function Check-AdminCredentials { # Получаем текущего пользователя env:USERNAME
# Проверяем, начинается ли имя пользователя с "wadmin" if (-not ($currentUser -like "wadmin*")) { Write-Host "Скрипт запущен не под учетной записью wadmin. Запрашиваем повышение привилегий..." -ForegroundColor Yellow Write-Host "Запуск скрипта с повышенными привилегиями... $PSScriptRoot" -ForegroundColor Green try { # Запускаем новый процесс PowerShell с повышенными привилегиями Start-Process -FilePath "powershell.exe" ` -Verb RunAs ` -ArgumentList "-ExecutionPolicy", "Bypass", "-File", "$PSCommandPath" Write-Host "Скрипт перезапущен с запросом повышения привилегий." -ForegroundColor Green Start-Sleep 6 exit # Завершаем текущий процесс } catch { Write-Host "Ошибка при запуске скрипта с повышенными привилегиями: $_" -ForegroundColor Red Start-Sleep 6 exit } } else { Write-Host "Скрипт запущен под правильной учетной записью" -ForegroundColor Green # Здесь продолжается выполнение основного кода скрипта }}
function Set-FullControlPermissions { param ( [string]$DestinationPath )
$SIDs = @( "S-1-5-18", # NT AUTHORITY\SYSTEM "S-1-5-32-544", # BUILTIN\Administrators (Get-ADGroup "SMZ File Admins").SID ) try { # Получение объекта папки по указанному пути $Folder = Get-Item -Path $DestinationPath # Получение ACL текущей папки $Acl = Get-Acl -Path $Folder.FullName # Отключение наследования и удаление унаследованных разрешений $Acl.SetAccessRuleProtection($true, $false) foreach ($SID in $SIDs) { $SecurityID = New-Object System.Security.Principal.SecurityIdentifier($SID) # Создание правила доступа для каждого SID с FullControl $AccessRule = New-Object System.Security.AccessControl.FileSystemAccessRule ( $SecurityID, "FullControl", "ContainerInherit, ObjectInherit", "None", "Allow" ) # Добавление правила доступа к ACL $Acl.AddAccessRule($AccessRule) } # Установка нового ACL для папки $Folder.SetAccessControl($Acl) Write-Host "Разрешения FullControl установлены для: $DestinationPath" } catch { Write-Host "Не удалось установить разрешения FullControl. Ошибка: $_" }}
Определение функций для установки разрешений
function Set-PermissionsForGroupsInFolder { [CmdletBinding()] param ( [string]filter_exp = AdGroups = Get-ADGroup -Filter "Description -like
"$filter_exp"" | Select-Object -ExpandProperty Nameforeach ($Group in $AdGroups) { Write-Host "Processing group: $Group" if ($Group.EndsWith(" R")) { $Permission = [System.Security.AccessControl.FileSystemRights]::ReadAndExecute } elseif ($Group.EndsWith(" M")) { $Permission = [System.Security.AccessControl.FileSystemRights]::Modify } else { Write-Host "Skipping group: $Group" continue } # Получаем текущий ACL папки $Acl = Get-Acl -Path $FolderPath $GroupSID = (Get-ADGroup $group).Sid # Создаем правило доступа $AccessRule = New-Object System.Security.AccessControl.FileSystemAccessRule($GroupSID, $Permission, "ContainerInherit,ObjectInherit", "None", "Allow") # Добавляем правило в ACL $Acl.AddAccessRule($AccessRule) # Устанавливаем новый ACL #Set-Acl -Path $FolderPath -AclObject $Acl (Get-Item $FolderPath).SetAccessControl($acl) Write-Host "Permissions set for group: $Group" }}
function Test-Credential { [CmdletBinding()] [OutputType( [Bool] )]
param ( [Parameter( Mandatory = $false )] [Alias( 'PSCredential' )] #[PSCredential] $Credential, [Parameter()] [String] $Domain ) if(-not [bool]$Credential){ Write-Host $Credential return $false } $Domain = $Credential.GetNetworkCredential().Domain [System.Reflection.Assembly]::LoadWithPartialName("System.DirectoryServices.AccountManagement") | Out-Null $principalContext = New-Object System.DirectoryServices.AccountManagement.PrincipalContext( [System.DirectoryServices.AccountManagement.ContextType]::Domain, $Domain ) $networkCredential = $Credential.GetNetworkCredential() Write-Output -InputObject $( $principalContext.ValidateCredentials( $networkCredential.UserName, $networkCredential.Password ) ) $principalContext.Dispose()}
function Get-AAdminCredentials { # Проверяем, существует ли переменная global:aadminCredentials) -and (Test-Credential -PSCredential global:aadminCredentials)) { # Проверяем, являются ли учетные данные валидными return global:aadminCredentials } else { env:USERNAME
# Проверяем, начинается ли имя пользователя с "wadmin" if ($currentUsername -like 'wadmin*') { # Заменяем начало "wadmin" на "aadmin" $adminUsername = $currentUsername -replace '^wadmin', 'aadmin' } else { # Добавляем "aadmin" в начало имени пользователя $adminUsername = "aadmin$currentUsername" } # Запрашиваем учетные данные с измененным именем пользователя $global:aadminCredentials = Get-Credential -UserName smzmi\$adminUsername -Message "Введите:" # Проверяем, являются ли учетные данные валидными if ([bool]($global:aadminCredentials) -and (Test-Credential -PSCredential $global:aadminCredentials)) { Write-Warning "Учетные данные $global:aadminCredentials валидны" return $global:aadminCredentials } else { Write-Warning "Учетные данные $global:aadminCredentials не валидны" Remove-Variable -Name aadminCredentials -Scope Global } }}
function Convert-ToTransliteration { param ( [string]$inputString )
# Обрезаем пустые пробелы по краям $inputString = $inputString.Trim() # Определяем таблицу соответствия $russianChars = "а","А","б","Б","в","В","г","Г","д","Д","е","Е","ё","Ё","ж","Ж","з","З","и","И","й","Й","к","К","л","Л","м","М","н","Н","о","О","п","П","р","Р","с","С","т","Т","у","У","ф","Ф","х","Х","ц","Ц","ч","Ч","ш","Ш","щ","Щ","ъ","Ъ","ы","Ы","ь","Ь","э","Э","ю","Ю","я","Я" $latinChars = "a","A","b","B","v","V","g","G","d","D","e","E","io","IO","zh","ZH","z","Z","i","I","y","I","k","K","l","L","m","M","n","N","o","O","p","P","r","R","s","S","t","T","u","U","f","F","h","H","cz","CZ","ch","CH","sh","SH","shh","SHH","yy","YY","y","Y","yh","YH","eh","EH","iu","IU","ia","IA" $transliteratedString = "" # Перебираем слово по буквам for ($i = 0; $i -lt $inputString.Length; $i++) { $index = -1 # Находим позицию заменяемой буквы в массиве do { $index++ } until (($inputString[$i] -ceq $russianChars[$index]) -or ($index -eq 100)) # Дополняем строку конвертированного текста, заменяя русскую букву на латинскую $transliteratedString += ($inputString[$i] -creplace $russianChars[$index], $latinChars[$index]) } return $transliteratedString}
function Generate-NewSecurityGroupName { param( [Parameter(Mandatory = pathString,
[Parameter(Mandatory = $true)] [ValidateSet("R", "M")] [string]$groupSuffix ) # Пример: # $pathString = "\\smzmi-win2\Teams\IS\Projects\0003_RUSSIA FRP SMZ MANUFACTURING APPLICATIONS PROJECT 2007\MES TMS design" # $pathString = "\\eursmz-hub21\teams\PCS" $transliteratedPath = Convert-ToTransliteration $pathString [System.Collections.ArrayList]$pathSegments = $transliteratedPath.Split("\",[System.StringSplitOptions]::RemoveEmptyEntries) $pathSegments.RemoveAt(0) $pathSegments.RemoveAt(0) if($pathSegments.Count -eq 1) { [string]$groupName = "" } else { [string]$groupName = "$($pathSegments[0])_" } for ($i=2; $i -lt $pathSegments.Count; $i++ ){ $groupName += "$($i)_" } $groupName += $pathSegments[-1] $groupName += " " $groupName += $groupSuffix $groupName = $groupName -replace '[;><"\\#+,]', '' return $groupName}
function Create-SecurityGroups { <# .SYNOPSIS Создает две глобальные группы безопасности в указанном OU и назначает пользователя ответственным за них.
.DESCRIPTION Функция принимает путь к сетевому каталогу и логин пользователя. Она создает две глобальные группы безопасности в OU=Groups1,OU=TEST,DC=smzmi,DC=local, имена которых формируются с помощью функции Generate-NewSecurityGroupName. Одна группа будет заканчиваться на " R", а другая на " M". Пользователь, указанный в параметре, назначается в качестве управляемого (ManagedBy) для обеих групп. В поле Description групп записывается путь к сетевому каталогу. .PARAMETER NetworkPath Путь к сетевому сетевому каталогу. .PARAMETER UserLogin Логин пользователя, который будет назначен в качестве управляемого для групп. .EXAMPLE Create-SecurityGroups -NetworkPath "\\smzmi-win2\Teams\IS\Projects" -UserLogin "jdoe" #> param( [Parameter(Mandatory = $true, HelpMessage = "Путь к сетевому каталогу")] [string]$NetworkPath, [Parameter(Mandatory = $true, HelpMessage = "Логин пользователя")] [string]$UserLogin ) try { # Получение DistinguishedName пользователя $user = Get-ADUser -Identity $UserLogin -Properties DistinguishedName -ErrorAction Stop } catch { Write-Error "Пользователь с логином '$UserLogin' не найден. Проверьте правильность ввода." return } # Формирование имен групп с суффиксами "R" и "M" $groupNameR = Generate-NewSecurityGroupName -pathString $NetworkPath -groupSuffix "R" $groupNameM = Generate-NewSecurityGroupName -pathString $NetworkPath -groupSuffix "M" # Определение пути к OU, где будут созданы группы #$organizationalUnitPath = "OU=Groups1,OU=TEST,DC=smzmi,DC=local" # Параметры общие для обеих групп $groupParameters = @{ Name = "" SamAccountName = "" GroupScope = "Global" GroupCategory = "Security" Path = $organizationalUnitPath Description = $NetworkPath ManagedBy = $user.DistinguishedName Credential = (Get-AAdminCredentials) } # Создание первой группы (заканчивается на "R") $groupParameters.Name = $groupNameR try { New-ADGroup @groupParameters -ErrorAction Stop Write-Host "Группа '$groupNameR' успешно создана." } catch { Write-Error "Не удалось создать группу '$groupNameR'. Ошибка: $_" } # Создание второй группы (заканчивается на "M") $groupParameters.Name = $groupNameM try { New-ADGroup @groupParameters -ErrorAction Stop Write-Host "Группа '$groupNameM' успешно создана." } catch { Write-Error "Не удалось создать группу '$groupNameM'. Ошибка: $_" }}
Создание формы
form.Text = "Установка разрешений для сетевого каталога" form.StartPosition = "CenterScreen"
Метка для пути
lblPath.Text = "Путь к сетевому каталогу:" lblPath.Size = New-Object System.Drawing.Size(200,20) lblPath)
Текстовое поле для ввода пути
txtPath.Location = New-Object System.Drawing.Point(10,45) form.Controls.Add($txtPath)
Кнопка Создать каталог
btnCreate.Text = "Создать каталог" btnCreate.Size = New-Object System.Drawing.Size(150,23) btnCreate)
Новая метка для логина пользователя
lblUserLogin.Text = "Логин пользователя, который будет назначан в ManagedBy:" lblUserLogin.Size = New-Object System.Drawing.Size(400,20) lblUserLogin)
Новое текстовое поле для ввода логина пользователя
txtUserLogin.Location = New-Object System.Drawing.Point(10,100) form.Controls.Add($txtUserLogin)
Метка для списка групп
lblGroups.Text = "Группы с явными разрешениями:" lblGroups.Location = New-Object System.Drawing.Point(10,135) # Смещено вниз lblGroups.Size = New-Object System.Drawing.Size(250,20) lblGroups)
Список для отображения групп
listGroups.Location = New-Object System.Drawing.Point(10,160) # Смещено вниз form.Controls.Add($listGroups)
Кнопка Получить группы
btnGetGroups.Text = "Получить группы" btnGetGroups.Location = New-Object System.Drawing.Point(10,375) # Смещено вниз btnGetGroups.Size = New-Object System.Drawing.Size(120,30) btnGetGroups)
Кнопка Назначить разрешения
btnSetPermissions.Text = "Назначить разрешения" btnSetPermissions.Location = New-Object System.Drawing.Point(150,375) # Смещено вниз btnSetPermissions.Size = New-Object System.Drawing.Size(150,30) btnSetPermissions)
Поле для отображения сообщений
txtLog.Location = New-Object System.Drawing.Point(10,410) # Смещено вниз txtLog.ReadOnly = form.Controls.Add($txtLog)
Обработчик кнопки Создать каталог
btnCreate.Add_Click({ path = path)) { [System.Windows.Forms.MessageBox]::Show("Пожалуйста, укажите путь к каталогу.", "Ошибка", "OK", "Error") return }
if (-Not (Test-Path -Path $path)) { try { New-Item -Path $path -ItemType Directory -Force | Out-Null [System.Windows.Forms.MessageBox]::Show("Каталог успешно создан.", "Успех", "OK", "Information") } catch { [System.Windows.Forms.MessageBox]::Show("Не удалось создать каталог. Ошибка: $_", "Ошибка", "OK", "Error") } } else { [System.Windows.Forms.MessageBox]::Show("Каталог уже существует.", "Информация", "OK", "Information") }})
Обработчик кнопки Получить группы
btnGetGroups.Add_Click({ listGroups.Items.Clear() txtPath.Text.Trim()
if (-Not (Test-Path -Path $path)) { [System.Windows.Forms.MessageBox]::Show("Указанный каталог не существует.", "Ошибка", "OK", "Error") return } try { $acl = Get-Acl -Path $path $accessRules = $acl.Access | Where-Object { -not $_.IsInherited } foreach ($rule in $accessRules) { $listGroups.Items.Add($rule.IdentityReference.Value) } if ($listGroups.Items.Count -eq 0) { $listGroups.Items.Add("Не найдено групп с явными разрешениями.") } $txtLog.Text = "Группы получены успешно." } catch { [System.Windows.Forms.MessageBox]::Show("Не удалось получить группы. Ошибка: $_", "Ошибка", "OK", "Error") }})
Обработчик кнопки Назначить разрешения
btnSetPermissions.Add_Click({ path = $txtPath.Text.Trim()
if (-Not (Test-Path -Path $path)) { $result = [System.Windows.Forms.MessageBox]::Show("Каталог не существует. Создать его?", "Подтверждение", "YesNo", "Question") if ($result -eq "Yes") { try { New-Item -Path $path -ItemType Directory -Force | Out-Null $txtLog.Text = "Каталог создан." } catch { [System.Windows.Forms.MessageBox]::Show("Не удалось создать каталог. Ошибка: $_", "Ошибка", "OK", "Error") return } } else { return } } try { # Выполнение функций последовательно Create-SecurityGroups -NetworkPath $path -UserLogin $txtUserLogin.Text Set-PermissionsForGroupsInFolder -FolderPath $path Set-FullControlPermissions -DestinationPath $path $listGroups.Items.Clear() $acl = Get-Acl -Path $path $accessRules = $acl.Access | Where-Object { -not $_.IsInherited } $listGroups.Items.Clear() foreach ($rule in $accessRules) { $listGroups.Items.Add($rule.IdentityReference.Value) } $txtLog.Text = "Разрешения назначены." } catch { [System.Windows.Forms.MessageBox]::Show("Не удалось назначить разрешения. Ошибка: $_", "Ошибка", "OK", "Error") $txtLog.Text = "Ошибка при назначении разрешений." }})
Проверка, что есть модуль ActiveDirectory
if (-not (Get-Module -Name ActiveDirectory -ListAvailable)) { Write-Host "Модуль ActiveDirectory не найден. Скрипт завершает работу." -ForegroundColor Red Start-Sleep 6 exit 1 }
Проверка что скрипт запущен с правами администратора
Check-AdminCredentials
Import-Module ActiveDirectory
$organizationalUnitPath = "OU=Groups1,OU=TEST,DC=smzmi,DC=local"
Отображение формы
[void]$form.ShowDialog()
- Assistant
Инструкция по использованию скрипта для установки разрешений сетевого каталога
Описание скрипта
Данный PowerShell-скрипт предназначен для автоматизации процесса установки разрешений на сетевые каталоги. Он позволяет:
- Проверить учетные данные текущего пользователя и при необходимости запросить повышение привилегий.
- Создавать необходимые каталоги в сетевом пространстве.
- Автоматически генерировать и создавать группы безопасности в Active Directory с соответствующими правами доступа.
- Назначать пользователю управление созданными группами.
- Устанавливать полные (FullControl) разрешения для определенных системных групп и созданных групп безопасности.
- Отображать текущие группы с явными разрешениями на выбранный каталог.
Предварительные требования
Перед использованием скрипта убедитесь, что:
-
Среда выполнения PowerShell:
- Используется PowerShell версии 5.1 или выше.
- Скрипт должен запускаться с правами администратора.
-
Модули и зависимости:
- Установлен модуль ActiveDirectory. Если модуль отсутствует, его необходимо установить:
Install-WindowsFeature -Name "RSAT-AD-PowerShell" - Убедитесь, что у вас есть необходимые права для создания групп в Active Directory и изменения разрешений на сетевые каталоги.
- Установлен модуль ActiveDirectory. Если модуль отсутствует, его необходимо установить:
-
Учетная запись пользователя:
- Скрипт проверяет, запущен ли он под учетной записью, начинающейся с
wadmin. В случае несоответствия будет запрошено повышение привилегий.
- Скрипт проверяет, запущен ли он под учетной записью, начинающейся с
Запуск скрипта
-
Открытие PowerShell с правами администратора:
- Щелкните правой кнопкой мыши по значку PowerShell и выберите "Запуск от имени администратора".
-
Выполнение скрипта:
- Сохраните скрипт в файл с расширением
.ps1, например,SetPermissions.ps1. - Перейдите в каталог с сохраненным скриптом:
cd путь\к\скрипту - Запустите скрипт:
.\SetPermissions.ps1
- Сохраните скрипт в файл с расширением
Пошаговое руководство по использованию графического интерфейса
После запуска скрипта откроется форма с графическим интерфейсом. Ниже приведено описание элементов интерфейса и их использование:
-
Поле "Путь к сетевому каталогу":
- Описание: Введите полный сетевой путь к каталогу, для которого необходимо установить разрешения. Пример:
\\smzmi-win2\Teams\IS\Projects\0003_RUSSIA\. - Действие: Введите или вставьте нужный путь в текстовое поле.
- Описание: Введите полный сетевой путь к каталогу, для которого необходимо установить разрешения. Пример:
-
Кнопка "Создать каталог":
- Описание: Создает указанный каталог, если он еще не существует.
- Действие: Нажмите кнопку после ввода пути. Если каталог уже существует, будет показано соответствующее уведомление.
-
Поле "Логин пользователя, который будет назначен в ManagedBy":
- Описание: Введите логин пользователя, который будет назначен ответственным (
ManagedBy) за создаваемые группы безопасности. - Действие: Введите логин пользователя в текстовое поле.
- Описание: Введите логин пользователя, который будет назначен ответственным (
-
Метка "Группы с явными разрешениями":
- Описание: Отображает список групп, которые имеют явные разрешения на выбранный каталог.
-
Кнопка "Получить группы":
- Описание: Получает и отображает список групп, имеющих явные разрешения на указанный каталог.
- Действие: Нажмите кнопку после создания или выбора каталога, чтобы увидеть текущие группы с доступом.
-
Кнопка "Назначить разрешения":
- Описание: Назначает полные разрешения (FullControl) на указанный каталог для системных групп и созданных групп безопасности.
- Действие:
- Убедитесь, что указанный каталог существует. Если нет, скрипт предложит создать его.
- Введите логин пользователя и нажмите кнопку.
- Скрипт автоматически создаст необходимые группы в Active Directory, назначит их ответственным и установит соответствующие разрешения на каталог.
-
Поле для отображения сообщений (txtLog):
- Описание: Отображает статус выполнения операций и информационные сообщения.
- Действие: Просматривайте поле для получения обратной связи о выполнении действий скрипта.
Пример использования
-
Создание каталога:
- Введите путь, например:
\\smzmi-win2\Teams\IS\Projects\0003_RUSSIA\. - Нажмите "Создать каталог".
- Если каталог успешно создан или уже существует, появится соответствующее сообщение.
- Введите путь, например:
-
Назначение пользователя:
- Введите логин пользователя, например:
jdoe.
- Введите логин пользователя, например:
-
Получение текущих групп:
- Нажмите "Получить группы", чтобы увидеть текущие группы с разрешениями на каталог.
-
Назначение разрешений:
- Нажмите "Назначить разрешения".
- Скрипт создаст необходимые группы в Active Directory, установит для них полные разрешения на каталог и обновит список групп в интерфейсе.
- В случае успешного выполнения появится сообщение "Разрешения назначены."
Возможные ошибки и их решения
-
Модуль ActiveDirectory не найден:
- Сообщение: "Модуль ActiveDirectory не найден. Скрипт завершает работу."
- Решение: Установите модуль ActiveDirectory, следуя предварительным требованиям.
-
Запуск не под учетной записью
wadmin:- Сообщение: Скрипт запросит повышение привилегий и попытается перезапуститься с правами администратора.
- Решение: Подтвердите запрос на повышение привилегий.
-
Ошибка при создании каталога:
- Сообщение: "Не удалось создать каталог. Ошибка: <подробности>"
- Решение: Проверьте правильность пути и наличие необходимых прав для создания каталогов.
-
Пользователь не найден в Active Directory:
- Сообщение: "Пользователь с логином '<логин>' не найден. Проверьте правильность ввода."
- Решение: Убедитесь, что введен корректный логин пользователя и он существует в Active Directory.
-
Ошибка при создании группы в Active Directory:
- Сообщение: "Не удалось создать группу '<имя группы>'. Ошибка: <подробности>"
- Решение: Проверьте наличие прав для создания групп в указочном OU и корректность параметров.
-
Ошибка при назначении разрешений:
- Сообщение: "Не удалось назначить разрешения. Ошибка: <подробности>"
- Решение: Проверьте наличие необходимых прав для изменения ACL на указанном каталоге и корректность введенных данных.
Дополнительная информация
-
Управление группами:
- Скрипт создает две группы безопасности для указанного каталога: одна с суффиксом
R(Read and Execute) и другая с суффиксомM(Modify). - Имена групп генерируются автоматически на основе пути к каталогу и транслитерации русских символов.
- Созданные группы получают полные разрешения на каталог и назначаются указанному пользователю в качестве владельца (
ManagedBy).
- Скрипт создает две группы безопасности для указанного каталога: одна с суффиксом
-
Транслитерация:
- Скрипт автоматически переводит русские символы в латинские для формирования корректных имен групп безопасности.
-
Повышение привилегий:
- При необходимости скрипт перезапустится с повышенными привилегиями, чтобы обеспечить выполнение всех операций.
Заключение
Данный скрипт значительно упрощает процесс управления разрешениями на сетевые каталоги, автоматизируя создание групп безопасности и настройку их прав доступа. Следуя данной инструкции, вы сможете эффективно использовать скрипт для обеспечения безопасности и управления доступом к ресурсам в вашей сети.