New-SPWOPIBinding

Crea un nuovo binding per associare estensioni di nomi di file o applicazioni ad azioni nella farm di SharePoint corrente in cui viene eseguito il cmdlet.

Sintassi

Default (Impostazione predefinita)

New-SPWOPIBinding
    -ServerName <String>
    [-Action <String>]
    [-AllowHTTP]
    [-Application <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Extension <String>]
    [-FileName <String>]
    [-ProgId <String>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Il New-SPWOPIBinding cmdlet associa le estensioni di file o le applicazioni alle azioni nella farm SharePoint corrente in cui viene eseguito questo cmdlet. Ogni binding consente di utilizzare l'applicazione WOPI per visualizzare o modificare i file nella raccolta di SharePoint. Ad esempio, quando un utente visualizza un documento di Word in un elenco di documenti di SharePoint, nell'elenco di SharePoint vengono visualizzate le opzioni disponibili per visualizzare o modificare il documento in base alle azioni associate a Word nella farm di SharePoint.

Per utilizzare un'applicazione WOPI, ad esempio un server che esegue Office App Web Server, per Office App Web, è necessario eseguire questo cmdlet nella farm di SharePoint prima di poter usare il App Web di Office.

Se si esegue New-SPWOPIBinding per un'applicazione o un'estensione di file in cui l'associazione (o l'associazione) esiste già, il cmdlet avrà esito negativo.

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

New-SPWOPIBinding -ServerName "Server.corp.Contoso.com"

In questo esempio vengono creati binding per tutte le applicazioni e le estensioni di file supportate dall'applicazione WOPI nella farm di SharePoint corrente in cui viene eseguito il cmdlet.

ESEMPIO 2

New-SPWOPIBinding -ServerName "Server.corp.Contoso.com" -Application "Excel"

In questo esempio viene associato Excel a tutte le azioni supportate dall'applicazione WOPI per Excel nella farm di SharePoint corrente in cui viene eseguito il cmdlet.

Parametri

-Action

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica l'azione da associare.

Ad esempio, "visualizza", "modifica" e "incorpora. view". Per un elenco delle azioni supportate dall'applicazione WOPI, eseguire Get-SPWOPIBinding. In genere, questo parametro non viene utilizzato.

Se si specificano alcune azioni ma non altre, alcune caratteristiche di SharePoint potrebbero non funzionare.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AllowHTTP

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica che il cmdlet può utilizzare HTTP per l'individuazione di quanto supportato dall'applicazione WOPI.

Se questo parametro viene impostato su True, le informazioni per l'individuazione provenienti dall'applicazione WOPI verranno inviate su una connessione non sicura.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Application

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica le applicazioni da associare.

Le applicazioni possibili sono le seguenti: "Word", "Excel", "PowerPoint" o "OneNote". Esegui Get-SPWOPIBinding per ottenere l'elenco completo delle applicazioni supportate dall'applicazione WOPI.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AssignmentCollection

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:SPAssignmentCollection
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Extension

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica le estensioni di file da associare.

Eseguire Get-SPWOPIBinding per ottenere l'elenco delle estensioni di file supportate dall'applicazione WOPI.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FileName

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica il percorso del file xml contenente le informazioni per l'individuazione per l'applicazione WOPI.

È possibile caricare informazioni per l'individuazione da un file xml anziché richiederle direttamente all'applicazione WOPI.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ProgId

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica l'identificatore programmatico (ProgID) di un'applicazione da associare.

Esegui Get-SPWOPIBinding per ottenere l'elenco dei ProgID supportati dall'applicazione WOPI.

È possibile utilizzare questo parametro solo per associare un'azione a una cartella di OneNote.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ServerName

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica il nome o il nome di dominio completo (FQDN) dell'applicazione WOPI, ad esempio un server che esegue il Server Office Web Apps.

Può essere anche un nome di dominio completo di un endpoint con bilanciamento del carico per più server di Office App Web.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.