Set-SPIRMSettings

Imposta le impostazioni di Information Rights Management (IRM).

Sintassi

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>]

Descrizione

Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.

Usare il Set-SPIRMSettings cmdlet per impostare le impostazioni di Information Rights Management (IRM) per il tenant.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

--------------ESEMPIO 1------------

Set-SPIRMSettings -RmsEnabled -UseActiveDirectoryDiscovery

In questo esempio IRM viene abilitato per la farm e configurato per l'utilizzo del server RMS predefinito configurato in Active Directory.

--------------ESEMPIO 2------------

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

In questo esempio viene abilitato IRM per la farm e viene specificato l'URL del server RMS da utilizzare.

--------------ESEMPIO 3------------

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

In questo esempio viene abilitato IRM per il tenant indicato e viene specificato l'URL del server RMS da utilizzare.

--------------ESEMPIO 4------------

Set-SPIRMSettings -RmsEnabled:$false

In questo esempio viene disabilitato IRM per la farm.

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

Specifica la password per l'accesso al certificato di autenticazione del servizio. Questa password è necessaria per l'installazione del certificato nell'archivio certificati del computer.

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

Specifica l'indirizzo del server di certificati RMS da utilizzare per il tenant.

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

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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

Specifica se IRM è abilitato per il tenant.

Il valore predefinito è 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

Specifica il certificato di autenticazione del servizio.

Se il parametro viene specificato e non è null, verrà utilizzato il certificato di autenticazione durante la connessione dalla farm al server RMS. Se invece il parametro non viene specificato, la farm locale si connetterà al server RMS utilizzando l'autenticazione integrata di 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

Specifica se è possibile configurare IRM nell'ambito di sottoscrizione sito.

Le sottoscrizioni sito possono configurare impostazioni IRM personalizzate solo se IRM è abilitato nell'ambito della farm.

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

Specifica se deve essere utilizzato il servizio RMS per l'individuazione che determinerà l'indirizzo del server RMS nel dominio.

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

Specifica se è necessario utilizzare OAuth.

I valori validi sono True e 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

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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