New-SearchDocumentFormat

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Questo cmdlet è disponibile solo in Exchange locale.

Usare il cmdlet New-SearchDocumentFormat per aggiungere un filtro specifico del formato a quelli usati dalla ricerca di Exchange.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

New-SearchDocumentFormat
   [-Identity] <SearchDocumentFormatId>
   -Extension <String>
   -MimeType <String>
   -Name <String>
   [-Confirm]
   [-Enabled <Boolean>]
   [-Server <ServerIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Dopo aver eseguito il cmdlet New-SearchDocumentFormat, è necessario eseguire il seguente cmdlet per riavviare il dispositivo di ricerca. Ci sarà una breve interruzione della ricerca.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

New-SearchDocumentFormat -Name "Proprietary SCT Formats" -MimeType text/scriptlet -Extension .sct -Identity ProprietarySCT1

In questo esempio viene creato un formato di documento di ricerca con estensione sct e un tipo MIME di testo/scriptlet.

Parametri

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

Il parametro Enabled consente di specificare se il nuovo formato viene attivato durante la creazione.

L'input valido per questo parametro è $true o $false. L'impostazione predefinita è $true.

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

-Extension

Il parametro Extension specifica il tipo di file da elaborare dal filtro ed è designato dall'estensione di file comune associata al tipo di file. Gli esempi includono .MP3, .JPG e .PNG. Prendere nota del periodo iniziale.

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

-Identity

Il parametro Identity identifica in modo univoco il nuovo formato del documento di ricerca. Ad esempio, l'identità di "PropSCT" può indicare un formato relativo al formato del documento proprietario supportato da un valore IFilter personalizzato. Il parametro Identity deve essere univoco all'interno dei formati relativi ai documenti di ricerca.

Type:SearchDocumentFormatId
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MimeType

Il parametro MimeType consente di specificare il tipo MIME del formato.

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

-Name

Il parametro Name consente di specificare un nome descrittivo per il formato, il quale può anche non essere univoco. Ad esempio, è possibile disporre di più formati differenti (supportati dal valore IFilters personalizzato), che vengono utilizzati per indicizzare gli output di un sistema proprietario chiamato "My Business Output". È possibile usare il parametro Name per creare una categoria di formati denominata "My Business Output Formats" e identificare in modo univoco ogni formato all'interno di tale gruppo usando il parametro Identity.

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

-Server

Il parametro Server specifica il server Exchange in cui si vuole eseguire il comando. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:

  • Nome
  • FQDN
  • Nome distinto (DN)
  • DN legacy di Exchange

DN legacy di Exchange

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

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

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

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.