Поделиться через


Set-SPIRMSettings

Задает параметры управления правами на доступ к данным (IRM).

Синтаксис

Set-SPIRMSettings
   -CertificateServerUrl <Uri>
   [-IrmEnabled]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CertificatePassword <SecureString>]
   [-Confirm]
   [-ServiceAuthenticationCertificate <X509Certificate2>]
   [-SubscriptionScopeSettingsEnabled]
   [-WhatIf]
   [-UseOauth]
   [<CommonParameters>]
Set-SPIRMSettings
   [-IrmEnabled]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CertificatePassword <SecureString>]
   [-Confirm]
   [-ServiceAuthenticationCertificate <X509Certificate2>]
   [-SubscriptionScopeSettingsEnabled]
   [-UseActiveDirectoryDiscovery]
   [-WhatIf]
   [-UseOauth]
   [<CommonParameters>]

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.

Set-SPIRMSettings Используйте командлет , чтобы задать параметры управления правами на доступ к данным (IRM) для клиента.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

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

Set-SPIRMSettings -RmsEnabled -UseActiveDirectoryDiscovery

В этом примере для фермы включается управление правами на доступ к данным, и настраивается использование сервера службы управления правами по умолчанию, настроенного в Active Directory.

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

Set-SPIRMSettings -RmsEnabled -CertificateServerUrl https://myrmsserver

В этом примере для фермы включается управление правами на доступ к данным, и задается URL-адрес используемого сервера службы управления правами.

--------------ПРИМЕР 3------------

site = Get-SPSite http://myspserver
$subscription = $site.SiteSubscription
Set-SPIRMSettings -SiteSubscription $subscription -RmsEnabled -CertificateServerUrl https://myrmsserver

В этом примере для указанного клиента включается управление правами на доступ к данным, и задается URL-адрес используемого сервера службы управления правами.

--------------ПРИМЕР 4------------

Set-SPIRMSettings -RmsEnabled:$false

В этом примере для фермы отключается управление правами на доступ к данным.

Параметры

-AssignmentCollection

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

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

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CertificatePassword

Задает пароль для доступа к сертификату проверки подлинности службы. Этот пароль необходим для установки сертификата в хранилище сертификатов компьютера.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CertificateServerUrl

Адрес сервера сертификации службы управления правами, который будет использоваться для клиента.

Type:Uri
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-IrmEnabled

Включает или отключает управление правами на доступ к данным для клиента.

Значение по умолчанию — false.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ServiceAuthenticationCertificate

Сертификат проверки подлинности службы.

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

Type:X509Certificate2
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SubscriptionScopeSettingsEnabled

Определяет возможность настройки управления правами на доступ к данным в области действия подписки на сайт.

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-UseActiveDirectoryDiscovery

Определяет возможность использования службы управления правами для определения адреса сервера этой службы в домене.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-UseOauth

Определяет, следует ли использовать OAuth.

Допустимые значения: True и False.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019