Compartilhar via

Set-SPIRMSettings

Módulo:
SharePointServer module

Define as configurações do Gerenciamento de Direitos de Informação (IRM).

Sintaxe

UseSpecifiedCertificateUrl 

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

UseServiceDiscovery 

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

Description

Este cmdlet contém mais de um parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

Utilize o Set-SPIRMSettings cmdlet para definir as definições de Gestão de Direitos de Informação (IRM) para o inquilino.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

EXEMPLO 1

Set-SPIRMSettings -RmsEnabled -UseActiveDirectoryDiscovery

Este exemplo habilita o IRM para o farm e o configura para usar o servidor RMS padrão configurado no Active Directory.

EXEMPLO 2

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

Este exemplo habilita o IRM para o farm e especifica o URL para o servidor RMS usar.

EXEMPLO 3

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

Este exemplo habilita o IRM para o inquilino especificado e especifica o URL para o servidor RMS usar.

EXEMPLO 4

Set-SPIRMSettings -RmsEnabled:$false

Este exemplo desabilita o IRM do farm.

Parâmetros

-AssignmentCollection

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CertificatePassword

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica a senha para acessar o Certificado de Autenticação de Serviço. Esta é necessária para instalar o certificado no repositório de certificados do computador.

Propriedades do parâmetro

Tipo:SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CertificateServerUrl

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica o endereço do servidor de certificado RMS para uso do inquilino.

Propriedades do parâmetro

Tipo:Uri
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UseSpecifiedCertificateUrl
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IrmEnabled

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica se o IRM é ou não habilitado no inquilino.

O valor padrão é falso.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ServiceAuthenticationCertificate

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica o certificado de autenticação de serviço.

Se o parâmetro é especificado e não nulo, o certificado de autenticação é usado quando conectar este farm para o servidor RMS. Se o parâmetro não é especificado, o farm local conecta-se ao servidor RMS usando a autenticação do Windows integrada.

Propriedades do parâmetro

Tipo:X509Certificate2
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SubscriptionScopeSettingsEnabled

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica se o IRM pode ou não ser configurado no escopo de assinatura do site.

As assinaturas do site podem apenas definir as configurações IRM personalizadas, se o IRM é habilitado no escopo do farm.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UseActiveDirectoryDiscovery

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica se o serviço RMS deve ou não ser usado para descoberta que determinará o endereço do servidor RMS no domínio.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UseServiceDiscovery
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UseOauth

Aplicável: SharePoint Server 2016, SharePoint Server 2019

Especifica se o OAuth deve ser usado.

Os valores válidos são Verdadeiro e Falso.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.