ITG.DomainUtils.Printers.Configuration.ps1

$ConfigCache = @{};

$ConfigContainerName = 'ITG DomainUtils';
$ConfigObjectName = 'ITG DomainUtils Printers';
$ConfigContainerParentDN = 'CN=Optional Features,CN=Directory Service,CN=Windows NT,CN=Services,CN=Configuration';
$ConfigContainerDN = ( ( "CN=$ConfigContainerName", $ConfigContainerParentDN | ? { $_ } ) -join ',' );
$ConfigObjectDN = ( ( "CN=$ConfigObjectName", $ConfigContainerDN | ? { $_ } ) -join ',' );

Function Initialize-DomainUtilsPrintersConfiguration {
<#
.Synopsis
	Èíèöèàëèçàöèÿ êîíôèãóðàöèè ìîäóëÿ. 
.Description
	Èíèöèàëèçèðóåò êîíôèãóðàöèþ ìîäóëÿ. Êîíôèãóðàöèÿ ìîäóëÿ ñîõðàíÿåòñÿ â Active Directory, ïîëíûé ïóòü
	äëÿ äîìåíà csm.nov.ru áóäåò
	`CN=ITG DomainUtils,CN=Optional Features,CN=Directory Service,CN=Windows NT,CN=Services,CN=Configuration,DC=csm,DC=nov,DC=ru`.
	
	Êîíôèãóðàöèÿ ñîõðàíÿåòñÿ â AD (è çàãðóæàåòñÿ èç AD) ïî ðÿäó ïðè÷èí.  ÷àñòíîñòè, ìîäóëü ïîääåðæèâàåò
	ëîêàëèçàöèþ è ïîääåðæèâàåò ðàçëè÷íûå êëàññû êîíòåéíåðîâ. Íî ñ ìîìåíòà íà÷àëà åãî ïðèìåíåíèÿ âñåìè
	àäìèíèñòðàòîðàìè äîìåíà äîëæíà èñïîëüçîâàòüñÿ îäíà è òà æå êîíôèãóðàöèÿ ìîäóëÿ, â ÷àñòíîñòè - òèïû
	êîíòåéíåðîâ, êîðíåâîé êîíòåéíåð äëÿ ðàçìåùåíèÿ ñîçäàâàåìûõ âñïîìîãàòåëüíûõ ãðóïï, è òàê äàëåå.

	 ñëó÷àå íàëè÷èÿ êîíôèãóðàöèè â AD å¸ ìîæíî ïðèíóäèòåëüíî ïåðåçàïèñàòü, èñïîëüçóÿ êëþ÷ `-Force`,
	îäíàêî ýòîò øàã íå ïðèâåä¸ò ê ôàêòè÷åñêîìó èçìåíåíèþ òèïîâ êîíòåéíåðîâ, èõ ìåñòîïîëîæåíèÿ,
	àòòðèáóòîâ ñîçäàííûõ ãðóïï. Ïîýòîìó ïîëüçîâàòüñÿ ýòîé âîçìîæíîñòüþ ñëåäóåò ñ îñîáîé îñòîðîæíîñòüþ.
.Link
	https://github.com/IT-Service/ITG.DomainUtils.Printers#Initialize-DomainUtilsPrintersConfiguration
.Example
	Initialize-DomainUtilsPrintersConfiguration
	Èíèöèàëèçèðóåì êîíôèãóðàöèþ ìîäóëÿ äëÿ äîìåíà ïîëüçîâàòåëÿ, îò èìåíè êîòîðîãî âûïîëíåí êîìàíäëåò.
#>
	[CmdletBinding(
		SupportsShouldProcess = $true
		, ConfirmImpact = 'High'
		, HelpUri = 'https://github.com/IT-Service/ITG.DomainUtils.Printers#Initialize-DomainUtilsPrintersConfiguration'
	)]

	param (
		# Äîìåí, äëÿ êîòîðîãî èíèöèàëèçèðóåì êîíôèãóðàöèþ ìîäóëÿ. Åñëè íå óêàçàí - äîìåí ïîëüçîâàòåëÿ, îò èìåíè êîòîðîãî çàïóùåí ñöåíàðèé.
		[Parameter(
			Mandatory = $false
		)]
		[String]
		$Domain = ( ( Get-ADDomain ).DNSRoot )
	,
		# Ïóòü (DN) ê êîíòåéíåðó AD, â êîòîðîì ðàñïîëîæåíû âñå êîíòåéíåðû, èñïîëüçóåìûå óòèëèòàìè äàííîãî ìîäóëÿ.
		# Óêàçûâàåòñÿ áåç DN äîìåíà.
		# Íàïðèìåð, äëÿ `CN=ITG,DC=csm,DC=nov,DC=ru` ñëåäóåò óêàçàòü `CN=ITG`.
		#
		# Ïî óìîë÷àíèþ â êà÷åñòâå êîðíåâîãî êîíòåéíåðà èñïîëüçóåòñÿ êîðíåâîé êîíòåéíåð äîìåíà.
		[Parameter(
			Mandatory = $false
		)]
		[String]
		$DomainUtilsBase
	,
		# Êëàññ êîíòåéíåðîâ, èñïîëüçóåìûõ äàííûì ìîäóëåì
		[Parameter(
			Mandatory = $false
		)]
		[String]
		[ValidateSet(
			'container'
			, 'organizationalUnit'
		)]
		$ContainerClass = 'container'
	,
		# Êîíòðîëëåð äîìåíà Active Directory. Åñëè íå óêàçàí ÿâíî - èñïîëüçóåòñÿ ýìóëÿòîð ðîëè PDC â óêàçàííîì äîìåíå.
		[Parameter(
			Mandatory = $false
		)]
		[String]
		$Server
	,
		# Ïåðåçàïèñûâàòü ëè êîíôèãóðàöèþ â ñëó÷àå å¸ íàëè÷èÿ
		[Switch]
		$Force
	)

	try {
		if ( -not  $Server ) {
			$Server = ( Get-ADDomainController `
				-Discover `
				-DomainName $Domain `
				-Writable `
				-Service PrimaryDC `
			).HostName;
		};
		$ADDomain = Get-ADDomain `
			-Identity $Domain `
			-Server $Server `
		;
		if ( 
			(
				Test-DomainUtilsPrintersConfiguration `
					-Domain $Domain `
					-Server $Server `
			) `
			-and -not $Force 
		) {
			Write-Error `
				-Message ( [String]::Format( $loc.ConfigExistsMessage, $ADDomain.DNSRoot ) ) `
				-Category ResourceExists `
				-CategoryActivity ( [String]::Format( $loc.ConfigInitialization, $ADDomain.DNSRoot ) ) `
				-CategoryReason ( [String]::Format( $loc.ConfigExistsMessage, $ADDomain.DNSRoot ) ) `
				-RecommendedAction ( [String]::Format( $loc.ConfigExistsRA, $ADDomain.DNSRoot ) ) `
			;
		} else {
			Write-Verbose `
				-Message ( [String]::Format( $loc.ConfigInitialization, $ADDomain.DNSRoot ) ) `
			;
            if ( -not ( Test-Path `
                -LiteralPath "AD:$( ( $ConfigContainerDN, $ADDomain.DistinguishedName | ? { $_ } ) -join ',' )" `
            ) ) {
				$null = New-ADObject `
					-Type 'container' `
					-Path ( ( $ConfigContainerParentDN, $ADDomain.DistinguishedName | ? { $_ } ) -join ',' ) `
					-Name $ConfigContainerName `
					-ProtectedFromAccidentalDeletion $false `
					-PassThru `
					-Verbose:$VerbosePreference `
					-Server $Server `
				;
            };
			if ( 
				Test-DomainUtilsPrintersConfiguration `
					-Domain $Domain `
					-Server $Server `
			) {
				$ConfigADObject = Get-ADObject `
					-Identity ( ( $ConfigObjectDN, $ADDomain.DistinguishedName | ? { $_ } ) -join ',' ) `
					-Server $Server `
					-Properties 'msDS-ObjectReference', 'msDS-Settings' `
				;
			};
			if ( -not $ConfigADObject ) {
				$ConfigADObject = New-ADObject `
					-Type 'msDS-App-Configuration' `
					-Path ( ( $ConfigContainerDN, $ADDomain.DistinguishedName | ? { $_ } ) -join ',' ) `
					-Name $ConfigObjectName `
					-ProtectedFromAccidentalDeletion $false `
					-PassThru `
					-Verbose:$VerbosePreference `
					-Server $Server `
				;
			};
			if ( $ConfigADObject ) {
				$ConfigADObject.'msDS-ObjectReference' = `
					( ( $DomainUtilsBase, $ADDomain.DistinguishedName | ? { $_ } ) -join ',' ) `
				;
				$ConfigADObject.'msDS-Settings' = `
					"ContainerClass=$ContainerClass" `
					, "PrintQueuesContainerName=$( $loc.PrintQueuesContainerName )" `
					, "PrintQueueContainerName=$( $loc.PrintQueueContainerName )" `
					, "PrintQueueUsersGroup=$( $loc.PrintQueueUsersGroup )" `
					, "PrintQueueUsersGroupAccountName=$( $loc.PrintQueueUsersGroupAccountName )" `
					, "PrintQueueAdministratorsGroup=$( $loc.PrintQueueAdministratorsGroup )" `
					, "PrintQueueAdministratorsGroupAccountName=$( $loc.PrintQueueAdministratorsGroupAccountName )" `
					, "PrintQueueGPOName=$( $loc.PrintQueueGPOName )" `
				;
				Set-ADObject `
					-Instance $ConfigADObject `
					-Verbose:$VerbosePreference `
					-Server $Server `
				;
				$null = Get-DomainUtilsPrintersConfiguration `
					-Domain $Domain `
					-Server $Server `
				;
			};
		};
	} catch {
		Write-Error `
			-ErrorRecord $_ `
		;
	};
}

Function Test-DomainUtilsPrintersConfiguration {
<#
.Synopsis
	Ïðîâåðÿåì íàëè÷èå êîíôèãóðàöèè ìîäóëÿ äëÿ óêàçàííîãî äîìåíà. 
.Description
	Ïðîâåðÿåì íàëè÷èå êîíôèãóðàöèè ìîäóëÿ äëÿ óêàçàííîãî äîìåíà. 
.Link
	https://github.com/IT-Service/ITG.DomainUtils.Printers#Test-DomainUtilsPrintersConfiguration
.Example
	Test-DomainUtilsPrintersConfiguration -Domain 'csm.nov.ru'
	Ïðîâåðÿåì ñóùåñòâîâàíèå êîíôèãóðàöèè äëÿ äîìåíà csm.nov.ru.
#>
	[CmdletBinding(
		HelpUri = 'https://github.com/IT-Service/ITG.DomainUtils.Printers#Test-DomainUtilsPrintersConfiguration'
	)]

	param (
		# äîìåí, äëÿ êîòîðîãî ïðîâåðÿåì íàëè÷èå êîíôèãóðàöèè ìîäóëÿ
		[Parameter(
			Mandatory = $false
		)]
		[String]
		$Domain = ( ( Get-ADDomain ).DNSRoot )
	,
		# Êîíòðîëëåð äîìåíà Active Directory
		[Parameter(
			Mandatory = $false
		)]
		[String]
		$Server
	)

	try {
		if ( -not  $Server ) {
			$Server = ( Get-ADDomainController `
				-Discover `
				-DomainName $Domain `
			).HostName;
		};
		$ADDomain = Get-ADDomain `
			-Identity $Domain `
			-Server $Server `
		;
		if ( $ConfigCache.ContainsKey( $ADDomain.DNSRoot ) ) { return $true; };
		return ( Test-Path -Path "AD:$( ( $ConfigObjectDN, $ADDomain.DistinguishedName | ? { $_ } ) -join ',' )" );
	} catch {
		Write-Error `
			-ErrorRecord $_ `
		;
	};
}

New-Alias -Name Test-Config -Value Test-DomainUtilsPrintersConfiguration -Force;

Function Get-DomainUtilsPrintersConfiguration {
<#
.Synopsis
	Ïîëó÷àåì îáúåêò, ñîäåðæàùèé êîíôèãóðàöèþ ìîäóëÿ äëÿ óêàçàííîãî äîìåíà. 
.Description
	Ïîëó÷àåì îáúåêò, ñîäåðæàùèé êîíôèãóðàöèþ ìîäóëÿ äëÿ óêàçàííîãî äîìåíà. 
.Link
	https://github.com/IT-Service/ITG.DomainUtils.Printers#Get-DomainUtilsPrintersConfiguration
.Example
	( Get-DomainUtilsPrintersConfiguration -Domain 'csm.nov.ru' ).ContainerClass
	Îïðåäåëÿåì êëàññ êîíòåéíåðîâ, èñïîëüçóåìûõ ìîäóëåì äëÿ äîìåíà csm.nov.ru.
#>
	[CmdletBinding(
		HelpUri = 'https://github.com/IT-Service/ITG.DomainUtils.Printers#Get-DomainUtilsPrintersConfiguration'
	)]

	param (
		# äîìåí, äëÿ êîòîðîãî çàïðàøèâàåì êîíôèãóðàöèþ ìîäóëÿ
		[Parameter(
			Mandatory = $false
		)]
		[String]
		$Domain = ( ( Get-ADDomain ).DNSRoot )
	,
		# Êîíòðîëëåð äîìåíà Active Directory
		[Parameter(
			Mandatory = $false
		)]
		[String]
		$Server
	,
		# Èãíîðèðîâàòü êåø è ïðèíóäèòåëüíî ïåðå÷èòàòü êîíôèãóðàöèþ èç AD
		[Switch]
		$NoCache
	)

	try {
		if ( -not  $Server ) {
			$Server = ( Get-ADDomainController `
				-Discover `
				-DomainName $Domain `
				-Writable `
				-Service PrimaryDC `
			).HostName;
		};
		$ADDomain = Get-ADDomain `
			-Identity $Domain `
			-Server $Server `
		;
		if (
			( -not $NoCache ) `
			-and ( $ConfigCache.ContainsKey( $ADDomain.DNSRoot ) )
		) {
			return $ConfigCache.Item( $ADDomain.DNSRoot );
		} else {
			if ( 
				-not (
					Test-DomainUtilsPrintersConfiguration `
						-Domain $Domain `
						-Server $Server `
				) `
			) {
				Write-Error `
					-Message ( [String]::Format( $loc.ConfigDoesntExistsMessage, $ADDomain.DNSRoot ) ) `
					-Category NotInstalled `
					-CategoryActivity ( [String]::Format( $loc.ConfigRetriving, $ADDomain.DNSRoot ) ) `
					-CategoryReason ( [String]::Format( $loc.ConfigDoesntExistsMessage, $ADDomain.DNSRoot ) ) `
					-RecommendedAction ( [String]::Format( $loc.ConfigDoesntExistsRA, $ADDomain.DNSRoot ) ) `
				;
			} else {
				$ConfigADObject = Get-ADObject `
					-Identity ( ( $ConfigObjectDN, $ADDomain.DistinguishedName | ? { $_ } ) -join ',' ) `
					-Server $Server `
					-Properties 'msDS-ObjectReference', 'msDS-Settings' `
				;
				$ConfigCache.Item( $ADDomain.DNSRoot ) = @{
					DomainUtilsBase = $ConfigADObject.'msDS-ObjectReference'[0];
				};
				$ConfigADObject.'msDS-Settings' `
				| % {
					if ( $_ -match '^(?<Param>\w+)=(?<Value>.*)$' ) {
						$ConfigCache.Item( $ADDomain.DNSRoot ).( $Matches[ 'Param' ] ) = $Matches[ 'Value' ];
					};
				};
		  		if ( $ConfigCache.Item( $ADDomain.DNSRoot ).ContainerClass -eq 'organizationalUnit' ) {
					$ConfigCache.Item( $ADDomain.DNSRoot ).ContainerPathTemplate = 'OU={0}';
				} else {
					$ConfigCache.Item( $ADDomain.DNSRoot ).ContainerPathTemplate = 'CN={0}';
				};
				$ConfigCache.Item( $ADDomain.DNSRoot ).PrintQueuesContainer = "$(
						[String]::Format(
							$ConfigCache.Item( $ADDomain.DNSRoot ).ContainerPathTemplate
							, $ConfigCache.Item( $ADDomain.DNSRoot ).PrintQueuesContainerName
						)
					),$( $ConfigCache.Item( $ADDomain.DNSRoot ).DomainUtilsBase )"
				;
				return $ConfigCache.Item( $ADDomain.DNSRoot );
			};
		};
	} catch {
		Write-Error `
			-ErrorRecord $_ `
		;
	};
}

New-Alias -Name Get-Config -Value Get-DomainUtilsPrintersConfiguration -Force;