Condividi tramite


Set-OfflineAddressBook

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Il cmdlet Set-OfflineAddressBook consente di modificare le impostazioni della Rubrica fuori rete.

In Exchange Online questo cmdlet è disponibile solo nel ruolo Elenchi indirizzi e per impostazione predefinita il ruolo non è assegnato ad alcun gruppo di ruoli. Per usare questo cmdlet, è necessario aggiungere il ruolo Elenchi indirizzi a un gruppo di ruoli, ad esempio al gruppo di ruoli Gestione organizzazione. Per ulteriori informazioni, vedere Aggiungere un ruolo a un gruppo di ruoli.

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

Sintassi

Set-OfflineAddressBook
   [-Identity] <OfflineAddressBookIdParameter>
   [-AddressLists <AddressBookBaseIdParameter[]>]
   [-ApplyMandatoryProperties]
   [-ConfiguredAttributes <MultiValuedProperty>]
   [-Confirm]
   [-DiffRetentionPeriod <Unlimited>]
   [-DomainController <Fqdn>]
   [-FullOabDownloadPreventionThreshold <Int32>]
   [-GeneratingMailbox <MailboxIdParameter>]
   [-GlobalWebDistributionEnabled <Boolean>]
   [-IsDefault <Boolean>]
   [-MaxBinaryPropertySize <Int32>]
   [-MaxMultivaluedBinaryPropertySize <Int32>]
   [-MaxMultivaluedStringPropertySize <Int32>]
   [-MaxStringPropertySize <Int32>]
   [-Name <String>]
   [-PublicFolderDistributionEnabled <Boolean>]
   [-Schedule <Schedule>]
   [-ShadowMailboxDistributionEnabled <Boolean>]
   [-UpgradeFromE14]
   [-UseDefaultAttributes]
   [-Versions <MultiValuedProperty>]
   [-VirtualDirectories <VirtualDirectoryIdParameter[]>]
   [-WhatIf]
   [-ZipOabFilesBeforeUploading <Boolean>]
   [<CommonParameters>]

Descrizione

È 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

Set-OfflineAddressBook -Identity "Default Offline Address Book" -VirtualDirectories $null -GlobalWebDistributionEnabled $true

In questo esempio la Rubrica offline predefinita, nota come OAB (Offline Address Book), viene configurata per essere disponibile per le richieste di download da tutte le directory virtuali della rubrica offline nell’organizzazione.

Esempio 2

Set-OfflineAddressBook -Identity "\Default Offline Address Book" -GeneratingMailbox OABGen2

In questo esempio la cassetta postale dell’organizzazione responsabile per la generazione della rubrica offline viene modificata.

Parametri

-AddressLists

Il parametro AddressLists consente di specificare gli elenchi indirizzi o gli elenchi indirizzi globali inclusi nella rubrica offline. È possibile utilizzare qualsiasi valore che identifichi l'elenco indirizzi in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

È possibile trovare i valori di identificazione degli elenchi indirizzi e degli elenchi indirizzi globali mediante i cmdlet Get-AddressList e Get-GlobalAddressList.

Type:AddressBookBaseIdParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ApplyMandatoryProperties

L’opzione ApplyMandatoryProperties consente di specificare se aggiornare le proprietà obbligatorie di una rubrica offline legacy. Con questa opzione non è necessario specificare alcun valore.

Questa opzione è stata usata negli ambienti di coesistenza quando è stata eseguita la migrazione di una rubrica offline da Exchange 2003.

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

-ConfiguredAttributes

Il parametro ConfiguredAttributes consente di specificare le proprietà MAPI dei destinatari disponibili nella rubrica offline. Questo parametro usa la sintassi: "Name1,Type1","Name2,Type2",..."NameN,TypeN" dove Name è il nome della proprietà MAPI (ad esempio MobileTelephoneNumber) e Type è il valore ANR (risoluzione del nome ambiguo), Value o Indicator.

Per ripristinare il parametro ai valori predefiniti, utilizzare l’opzione UseDefaultAttributes.

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

-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DiffRetentionPeriod

Il parametro DiffRetentionPeriod consente di specificare il numero di giorni di archiviazione nel server dei file di differenza della rubrica offline. I valori validi comprendono i numeri interi da 7 a 1825 o il valore unlimited. Il valore predefinito è 30.

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

-DomainController

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

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

-FullOabDownloadPreventionThreshold

Questo parametro è riservato all'uso interno da parte di Microsoft.

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

-GeneratingMailbox

Questo parametro è disponibile solo in Exchange locale.

Il parametro GeneratingMailbox consente di specificare la cassetta postale di arbitrato in cui viene generata la rubrica offline. In particolare, la cassetta postale di arbitrato deve contenere il valore OrganizationCapabilityOABGen per la proprietà PersistedCapability. Una cassetta postale di arbitrato con questa funzionalità è nota anche come cassetta postale dell’organizzazione. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\nomeutente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (UPN)

Il valore predefinito per questo parametro è la cassetta postale dell’organizzazione denominata SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c}.

Una singola cassetta postale dell'organizzazione può generare più OAB (è possibile usare lo stesso valore per questo parametro nelle impostazioni di più OAB), ma in Exchange 2013 CU5 o versioni successive una rubrica offline può essere generata solo da una singola cassetta postale dell'organizzazione (questo parametro non accetta più valori). Per avere una copia di sola lettura della rubrica offline (nota anche come copia shadow) disponibile in altre cassette postali dell'organizzazione, utilizzare il parametro ShadowMailboxDistributionEnabled.

Type:MailboxIdParameter
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

-GlobalWebDistributionEnabled

Questo parametro è disponibile solo in Exchange locale.

Il parametro GlobalWebDistributionEnabled consente di specificare se tutte le directory virtuali della rubrica offline dell'organizzazione possono accettare richieste di download della rubrica offline. Queste posizioni sono indicate dal servizio di individuazione automatica. I valori validi sono:

  • $true: qualsiasi directory virtuale della Rubrica offline nell'organizzazione può accettare richieste per scaricare la Rubrica offline. Non è possibile utilizzare questa impostazione con il parametro VirtualDirectories.
  • $false: solo le directory virtuali della Rubrica offline specificate dal parametro VirtualDirectories accettano le richieste di download della rubrica offline. Questo è il valore predefinito.

In Exchange 2013 CU7 o versioni successive è consigliabile usare il valore $true per questo parametro. I servizi di Accesso client in un server Cassette postali possono eseguire il proxy delle richieste di download della rubrica offline in arrivo nella posizione corretta.

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

-Identity

Il parametro Identity consente di specificare la rubrica offline che si desidera modificare. È possibile utilizzare qualsiasi valore che identifica la rubrica offline in maniera univoca. Ad esempio:

  • Nome o \Nome
  • Nome distinto (DN)
  • GUID
Type:OfflineAddressBookIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IsDefault

Il parametro IsDefault consente di specificare se la rubrica offline viene utilizzata da tutte le cassette postali e i database delle cassette postali per cui non è specificata una rubrica offline. I valori validi sono:

  • $true: la rubrica offline è la rubrica offline predefinita.
  • $false: la rubrica offline non è la rubrica offline predefinita.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-MaxBinaryPropertySize

Questo parametro è disponibile solo in Exchange locale.

Il parametro MaxBinaryPropertySize consente di specificare la dimensione massima in byte per gli attributi binari della rubrica offline prima che vengano troncati. Sono consentiti numeri interi compresi tra 0 e 999999999. Il valore predefinito è 65536.

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

-MaxMultivaluedBinaryPropertySize

Questo parametro è disponibile solo in Exchange locale.

Il parametro MaxMultivaluedBinaryPropertySize consente di specificare la dimensione massima in byte per gli attributi binari multivalore della rubrica offline prima che vengano troncati. Sono consentiti numeri interi compresi tra 0 e 999999999. Il valore predefinito è 65536 (64 kilobyte).

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

-MaxMultivaluedStringPropertySize

Questo parametro è disponibile solo in Exchange locale.

Il parametro MaxMultivaluedStringPropertySize consente di specificare la dimensione massima per gli attributi della stringa multivalore della rubrica offline prima che vengano troncati. Sono consentiti numeri interi compresi tra 0 e 999999999. Il valore predefinito è 65536 (64 kilobyte).

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

-MaxStringPropertySize

Questo parametro è disponibile solo in Exchange locale.

Il parametro MaxStringPropertySize consente di specificare la dimensione massima in byte per gli attributi della stringa prima che vengano troncati. Sono consentiti numeri interi compresi tra 0 e 999999999. Il valore predefinito è 3400.

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

-Name

Il parametro Name consente di specificare il nome univoco della rubrica offline. La lunghezza massima è 64 caratteri. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.

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

-PublicFolderDistributionEnabled

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro PublicFolderDistributionEnabled specifica se la rubrica offline deve essere distribuita tramite cartelle pubbliche. L'impostazione del parametro PublicFolderDistributionEnabled su un valore di $true imposta la rubrica offline da distribuire tramite cartelle pubbliche. Il valore predefinito è $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Schedule

Questo parametro funziona solo in Exchange 2010.

In Exchange 2013 o versioni successive questo parametro non è più responsabile della pianificazione di generazione della rubrica offline. Per altre informazioni, vedere Modificare la pianificazione di generazione della rubrica offline in Exchange.

Il parametro Schedule consente di specificare l'intervallo per la generazione della rubrica offline in Exchange 2010 o versioni precedenti.

La sintassi per questo parametro è: StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM].

È possibile usare i valori seguenti per i giorni:

  • Nome completo del giorno.
  • Nome abbreviato del giorno.
  • Intero compreso tra 0 e 6, dove 0 = domenica.

È possibile immettere l'ora in formato 24 ore e omettere il valore AM/PM. Se si immette l'ora in formato 12 ore temporali, includere uno spazio tra l'ora e il valore AM/PM.

È possibile combinare e abbinare i formati di data/ora.

Tra l'ora di inizio e di fine devono intercorrere almeno 15 minuti. I minuti saranno arrotondati a 0, 15, 30 o 45.

Ecco alcuni esempi:

  • "Dom. 23.30-Lun. 01.30"
  • "6.22:00-6.22:15" (Eseguire da sabato alle 22:00 fino a sabato alle 22:15).
  • "Dom.1:15-Lunedì.23:00"

Nota: in Exchange Online, il valore di sola lettura di questa proprietà viene visualizzato nell'ora UTC (Coordinated Universal Time).

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

-ShadowMailboxDistributionEnabled

Questo parametro è disponibile solo in Exchange locale.

Il parametro ShadowMailboxDistributionEnabled consente di specificare se una copia di sola lettura della rubrica offline (anche nota come copia shadow) viene distribuita a tutte le altre cassette postali per la generazione della rubrica offline (anche note come cassette postali dell'organizzazione). Ciò consente a ulteriori server Cassette postali di essere gli endpoint per le richieste di download della rubrica offline e contribuisce a prevenire che gli utenti scarichino la rubrica offline attraverso collegamenti WAN lenti. I valori validi sono:

  • $true: la rubrica offline viene distribuita a tutte le altre cassette postali dell'organizzazione.
  • $false: la rubrica offline non è distribuita ad altre cassette postali dell'organizzazione. Questo è il valore predefinito.

Il valore di questo parametro è significativo solo se si dispone di più cassette postali dell'organizzazione ed è vantaggioso solo nelle organizzazioni di Exchange con più siti di Active Directory.

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

-UpgradeFromE14

Questo parametro è riservato all'uso interno da parte di Microsoft.

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

-UseDefaultAttributes

L’opzione UseDefaultAttributes consente di specificare se ripristinare le proprietà MAPI dei destinatari disponibili nella rubrica offline all’elenco predefinito. Con questa opzione non è necessario specificare alcun valore.

È possibile utilizzare questa opzione per annullare le modifiche apportate all'elenco predefinito tramite il parametro ConfiguredAttributes.

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

-Versions

Il parametro Versions consente di specificare le versioni della rubrica offline generata per il download del client. I valori validi sono:

  • Version2 (richiede la distribuzione di cartelle pubbliche)
  • Version3 (richiede la distribuzione di cartelle pubbliche)
  • Version4 (valore predefinito in Exchange 2010 o versione successiva; l'unico valore disponibile in Exchange 2013 o versione successiva)
Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-VirtualDirectories

Questo parametro è disponibile solo in Exchange locale.

Il parametro VirtualDirectories consente di specificare le directory virtuali della Rubrica offline che accettano le richieste di download della rubrica offline. Queste posizioni sono indicate nel servizio di individuazione automatica.

È possibile utilizzare qualsiasi valore che identifichi la directory virtuale in modo univoco. Ad esempio:

  • Nome o Server\Nome
  • Nome distinto (DN)
  • GUID

Il valore Name usa la sintassi "VirtualDirectoryName (WebsiteName)" delle proprietà della directory virtuale. È possibile specificare il carattere jolly (*) anziché il sito Web predefinito usando la sintassi VirtualDirectoryName*.

Il valore predefinito di questo parametro è rappresentato dalle directory virtuali dei servizi accesso client (front-end) e della rubrica offline back-end nel server Cassette postali che contiene la cassetta postale di generazione della rubrica offline (il parametro GeneratingMailbox o SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c}) quando è stata creata la rubrica offline ( ad esempio, Mailbox01\OAB (sito Web predefinito),Mailbox01\OAB (back-end di Exchange).

Per utilizzare questo parametro, il valore del parametro GlobalWebDistributionEnabled deve essere $false.

In Exchange 2013 CU7 o versioni successive è consigliabile impostare questo parametro su $null e quindi impostare il parametro GlobalWebDistributionEnabled su $true, perché i servizi Accesso client in qualsiasi server Cassette postali possono eseguire il proxy delle richieste di download della Rubrica offline in ingresso nel percorso corretto.

Type:VirtualDirectoryIdParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ZipOabFilesBeforeUploading

ZipOabFilesBeforeUploading specifica se utilizzare la compressione dei file ZIP nei file della rubrica offline prima di caricarli nel server. I valori validi sono:

  • $true: comprimere i file della rubrica offline.
  • $false: non comprimere i file della rubrica offline. Questo è il valore predefinito.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

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.