about_Data_Sections

РАЗДЕЛ
	about_Data_Sections

КРАТКОЕ ОПИСАНИЕ
	Описывает разделы Data, позволяющие отделить текстовые строки и 
	другие данные, предназначенные только для чтения, от логики скрипта.


ПОЛНОЕ ОПИСАНИЕ
	Скрипты, предназначенные для Windows PowerShell, могут содержать 
	один или несколько разделов Data, в которых хранятся только 
	данные. Один или несколько разделов Data можно добавить в любой 
	скрипт, функцию или расширенную функцию. Содержимое раздела Data 
	ограничено определенным поднабором языка скриптов Windows PowerShell.

	Отделение данных от логики кода упрощает идентификацию и 
	управление как логикой, так и данными. Это разделение позволяет 
	создавать отдельные файлы строковых ресурсов для вывода текстовых 
	сообщений, например сообщений об ошибках и строк справки. Кроме 
	того, такой подход позволяет выделить логику кода, что упрощает 
	обеспечение безопасности и проведение тестирования. 

	Раздел Data используется в Windows PowerShell 2.0 для поддержки 
	перевода скрипта на различные языки. Разделы Data можно использовать 
	для упрощения отделения, обнаружения и обработки строк, которые 
	будут переведены на различные языки пользовательского интерфейса. 

	Раздел Data является функцией Windows PowerShell 2.0. Скрипты с 
	разделами Data не будут работать в Windows PowerShell 1.0, если 
	не внести в них изменения.


  Синтаксис

	Для раздела Data используется следующий синтаксис:

		DATA [-supportedCommand <имя_командлета>] {

			<Разрешенное_содержимое>
	}


	Ключевое слово Data является обязательным. Регистр символов не имеет 
	значения.


	Разрешенное содержимое ограничивается следующими элементами.

		- Все операторы Windows PowerShell, за исключением -match	
		- Инструкции If, Else и ElseIf
		 
		- Следующие автоматические переменные: $PSCulture, $PSUICulture, $True, 
		$False и $Null.

		- Комментарии

		- Конвейеры

		- Инструкции разделяются точкой с запятой (;).

		- Литералы, например следующие:

			a

			1
  
			1,2,3
	
			"Windows PowerShell 2.0"

			@( "red", "green", "blue" )

			@{ a = 0x1; b = "great"; c ="script" }

			[XML] @'
			 <p> Hello, World </p>
			'@

		- Командлеты, которые могут использоваться в разделе Data. 
		По умолчанию допускается использование только командлета 
		ConvertFrom-StringData.

		- Командлеты, которые пользователь разрешил использовать в 
		разделе Data с использованием параметра SupportedCommand.


	Если командлет ConvertFrom-StringData используется в разделе 
	Data, можно заключать пары "ключ-значение" в строки или 
	автономные строки в одиночных или двойных кавычках. Однако строки, 
	содержащие переменные и подвыражения, должны заключаться в строки 
	или автономные строки в одиночных кавычках, чтобы вместо переменных 
	не подставлялись значения, а подвыражения не могли выполняться. 


  SupportedCommand

	Параметр SupportedCommand позволяет указать, что командлет или 
	функция только создает данные. Этот параметр позволяет пользователям 
	включать в раздел Data командлеты и функции, написанные или 
	протестированные пользователями.

	В качестве значения параметра SupportedCommand используется 
	разделенный запятыми список имен командлетов и функций.

	Например, в следующий раздел данных включен написанный пользователем 
	командлет, Format-XML, который форматирует данные в XML-файле.

		DATA -supportedCommand Format-XML 
		{ 
			 Format-XML -strings string1, string2, string3
	}	 


  Использование раздела Data

	Для использования содержимого раздела Data присвойте его 
	переменной и выполняйте доступ к содержимому с помощью 
	синтаксиса работы с переменными.

	Например, в следующем разделе данных содержится команда ConvertFrom-
	StringData, которая конвертирует автономную строку в хэш-таблицу. 
	Хэш-таблица сохраняется в переменной $TextMsgs. 

	Переменная $TextMsgs не является частью раздела данных.
 
		$TextMsgs = DATA {
			ConvertFrom-StringData -stringdata @'
				Text001 = Windows 7
				Text002 = Windows Server 2008 R2
		'@
	}
	 
	Для доступа к ключам и значениям в хэш-таблице, сохраненной в 
	переменной $TextMsgs, используются следующие команды.

		$TextMsgs.Text001   
		$TextMsgs.Text002



ПРИМЕРЫ

	Простые строки данных.

		DATA {
			"Благодарю вас за использование моего скрипта Windows PowerShell Organize.pst." 
			"Он бесплатно предоставляется всем желающим." 
			"Буду благодарен за отзывы и комментарии." 
	}


	Строки, содержащие разрешенные переменные..

		DATA {
			if ($null) {
			 "Для отображения справки для этого командлета введите команду get-
			 help new-dictionary." 
		}
	}	 
			

	Автономная строка в одиночных кавычках, которая использует командлет 
	ConvertFrom-StringData:

		DATA {
		ConvertFrom-StringData -stringdata @' 
			Text001 = Windows 7
			Text002 = Windows Server 2008 R2
		'@
	}



	Автономная строка в двойных кавычках, которая использует командлет 
	ConvertFrom-StringData:

		DATA {
		ConvertFrom-StringData -stringdata @" 
			Msg1 = Для запуска нажмите любую клавишу.
			Msg2 = Для завершения работы введите "quit".
		"@
	}



	Раздел данных, содержащий написанный пользователем командлет, который 
	генерирует данные.

		DATA -supportedCommand Format-XML { 
		 Format-XML -strings string1, string2, string3
	}


СМ. ТАКЖЕ
	about_Automatic_Variables
	about_Comparison_Operators
	about_Hash_Tables
	about_If
	about_Operators
	about_Quoting_Rules
	about_Script_Internationalization
	ConvertFrom-StringData
	Import-LocalizedData