Set-SPMachineKey

Ссылка

Модуль:: sharepoint-server

Применяется к:: SharePoint Server Subscription Edition

Настраивает ключи расшифровки и проверки состояния ASP.NET просмотра веб-приложения.

Синтаксис

Set-SPMachineKey
   -WebApplication <SPWebApplicationPipeBind>
   [-DecryptionKey <String>]
   [-ValidationKey <String>]
   [-Local]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-SPMachineKey настраивает ключи расшифровки и проверки состояния ASP.NET просмотра веб-приложения.

Примеры

-------------ПРИМЕР 1-------------

Set-SPMachineKey -WebApplication http://sitename

В этом примере задаются ключи расшифровки и проверки состояния ASP.NET представления для веб-приложения "http://sitename" на новые случайно созданные ключи. Новые ключи развертываются на всех серверах фермы.

-------------ПРИМЕР 2-------------

Set-SPMachineKey -WebApplication http://sitename -DecryptionKey '<Your Key!>' -ValidationKey '<Your Key!>' -Local

В предыдущем примере для ASP.NET просмотра ключей расшифровки состояния и проверки веб-приложения "http://sitename" задаются новые ключи, заданные параметрами DecryptionKey и ValidationKey. Новые ключи развертываются только на локальном сервере. Другие серверы фермы будут по-прежнему использовать предыдущие ключи.

Сведения о создании ключей <machineKey> element см. в статье о поддержке устранения ошибок с кодом проверки подлинности сообщений о состоянии (MAC).

Параметры

-AssignmentCollection

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.

Тип:	SPAssignmentCollection
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False
Применяется к:	SharePoint Server Subscription Edition

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	SharePoint Server Subscription Edition

-DecryptionKey

Указывает новый ключ расшифровки состояния представления ASP.NET. Ключ должен быть представлен в виде шестнадцатеричной строки длиной 64 символов (0–9 и A–F).

Если этот параметр не указан, будет создан и использован случайный ключ расшифровки.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	SharePoint Server Subscription Edition

-Local

Развертывайте новые ключи расшифровки и проверки только на локальном сервере. Другие серверы в ферме будут по-прежнему использовать предыдущие ключи расшифровки и проверки. Если эти ключи не синхронизированы на каждом сервере фермы, веб-сеансы с балансировкой нагрузки на нескольких серверах фермы завершатся ошибкой. Используйте командлет Update-SPMachineKey для развертывания ключей на дополнительных серверах фермы.

Если этот параметр не указан, новые ключи расшифровки и проверки будут развернуты на всех серверах фермы.

Тип:	SwitchParameter
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	SharePoint Server Subscription Edition

-ValidationKey

Указывает новый ключ проверки состояния ASP.NET просмотра. Ключ должен быть представлен в виде шестнадцатеричной строки длиной 64 символов (0–9 и A–F).

Если этот параметр не указан, будет создан и использован случайный ключ расшифровки.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	SharePoint Server Subscription Edition

-WebApplication

Указывает имя, URL-адрес или GUID веб-приложения.

Тип:	SPWebApplicationPipeBind
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False
Применяется к:	SharePoint Server Subscription Edition

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет при этом не запускается.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	SharePoint Server Subscription Edition