Condividi tramite


New-OfflineAddressBook

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi per un ambiente o l'altro.

Usare il cmdlet New-OfflineAddressBook per creare rubriche offline.

In Exchange Online questo cmdlet è disponibile solo nel ruolo Indirizzo Elenchi e per impostazione predefinita il ruolo non è assegnato ad alcun gruppo di ruoli. Per usare questo cmdlet, è necessario aggiungere il ruolo Address Elenchi 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

Default (impostazione predefinita).

New-OfflineAddressBook
    [-Name] <String>
    -AddressLists <AddressBookBaseIdParameter[]>
    [-Confirm]
    [-DiffRetentionPeriod <Unlimited>]
    [-DomainController <Fqdn>]
    [-GeneratingMailbox <MailboxIdParameter>]
    [-GlobalWebDistributionEnabled <Boolean>]
    [-IsDefault <Boolean>]
    [-PublicFolderDatabase <DatabaseIdParameter>]
    [-PublicFolderDistributionEnabled <Boolean>]
    [-Schedule <Schedule>]
    [-Server <ServerIdParameter>]
    [-ShadowMailboxDistributionEnabled <Boolean>]
    [-SkipPublicFolderInitialization]
    [-Versions <MultiValuedProperty>]
    [-VirtualDirectories <VirtualDirectoryIdParameter[]>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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

$a = Get-AddressList | Where {$_.Name -Like "*AgencyB*"}

New-OfflineAddressBook -Name "OAB_AgencyB" -Server myserver.contoso.com -AddressLists $a -Schedule "Mon.01:00-Mon.02:00, Wed.01:00-Wed.02:00"

In Exchange Server 2010 e 2013 questo esempio usa due comandi per creare la rubrica offline denominata OAB_AgencyB che include tutti gli elenchi di indirizzi in cui AgencyB fa parte del nome. Usando le impostazioni visualizzate, una rubrica offline viene generata da myserver.contoso.com il lunedì e il mercoledì dalle 01:00 (1:00) alle 02:00 (02:00). Questo comando di esempio crea anche la rubrica offline predefinita per l'organizzazione.

Esempio 2

New-OfflineAddressBook -Name "Contoso Executives OAB" -AddressLists "Default Global Address List","Contoso Executives Address List" -GlobalWebDistributionEnabled $true

In questo esempio viene creata una nuova rubrica offline denominata Contoso Executives OAB con le proprietà seguenti:

  • Elenchi di indirizzi inclusi nella Rubrica offline: Elenco indirizzi globale predefinito e Elenco indirizzi dirigenti Contoso
  • Tutte le directory virtuali della Rubrica offline nell'organizzazione possono accettare richieste per scaricare la Rubrica offline.

La cassetta postale dell'organizzazione responsabile della generazione della rubrica offline è SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c} (non è stato usato il parametro GeneratingMailbox per specificare una cassetta postale dell'organizzazione diversa).

La rubrica offline non viene usata dalle cassette postali e dai database delle cassette postali in cui non è specificata una rubrica offline (non è stato usato il parametro IsDefault con il valore $true).

Esempio 3

New-OfflineAddressBook -Name "New OAB" -AddressLists "\Default Global Address List" -Server SERVER01 -VirtualDirectories "SERVER01\OAB (Default Web Site)"

In Exchange Server 2010, in questo esempio viene creata la nuova rubrica offline della rubrica offline che usa la distribuzione basata sul Web per i client di Microsoft Office Outlook 2007 o versioni successive in SERVER01 usando la directory virtuale predefinita.

Esempio 4

New-OfflineAddressBook -Name "Legacy OAB" -AddressLists "\Default Global Address List" -Server SERVER01 -PublicFolderDatabase "PFDatabase" -PublicFolderDistributionEnabled $true -Versions Version1,Version2

In Exchange Server 2010 questo esempio crea la rubrica offline legacy della Rubrica offline legacy che usa la distribuzione di cartelle pubbliche per i client Outlook 2003 Service Pack 1 (SP1) e Outlook 98 Service Pack 2 (SP2) in SERVER01.

Se si configurano OAB per l'uso della distribuzione di cartelle pubbliche, ma l'organizzazione non dispone di un'infrastruttura di cartelle pubbliche, viene restituito un errore. Per altre informazioni, vedere Gestione delle cartelle pubbliche.

Parametri

-AddressLists

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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 richiedono le virgolette, utilizzare 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.

Proprietà dei parametri

Tipo:

AddressBookBaseIdParameter[]

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

-Confirm

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. 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.

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

-DiffRetentionPeriod

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.

Proprietà dei parametri

Tipo:Unlimited
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

-DomainController

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Proprietà dei parametri

Tipo:Fqdn
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

-GeneratingMailbox

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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\Nome utente
  • 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.

Proprietà dei parametri

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

-GlobalWebDistributionEnabled

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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 valore è 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.

Proprietà dei parametri

Tipo:Boolean
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

-IsDefault

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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. Questo valore è il valore predefinito.

Proprietà dei parametri

Tipo:Boolean
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

-Name

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.

Proprietà dei parametri

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

Set di parametri

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

-PublicFolderDatabase

Applicabile: Exchange Server 2010

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro PublicFolderDatabase consente di specificare il database delle cartelle pubbliche usato per distribuire la rubrica offline. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

Per utilizzare questo parametro, il parametro PublicFolderDistributionEnabled deve essere impostato su $true.

Proprietà dei parametri

Tipo:DatabaseIdParameter
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

-PublicFolderDistributionEnabled

Applicabile: Exchange Server 2010

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro PublicFolderDistributionEnabled specifica se la rubrica offline viene distribuita tramite cartelle pubbliche. Se il valore del parametro PublicFolderDistributionEnabled è $true, la rubrica offline viene distribuita tramite cartelle pubbliche.

Proprietà dei parametri

Tipo:Boolean
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

-Schedule

Applicabile: Exchange Server 2010

Questo parametro è disponibile solo in Exchange Server 2010.

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"

Proprietà dei parametri

Tipo:Schedule
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

-Server

Applicabile: Exchange Server 2010

Questo parametro è disponibile solo in Exchange Server 2010.

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)
  • ExchangeLegacyDN

DN legacy di Exchange

Proprietà dei parametri

Tipo:ServerIdParameter
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à:True
Valore dagli argomenti rimanenti:False

-ShadowMailboxDistributionEnabled

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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 valore è 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.

Proprietà dei parametri

Tipo:Boolean
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

-SkipPublicFolderInitialization

Applicabile: Exchange Server 2010

Questo parametro è disponibile solo in Exchange Server 2010.

L'opzione SkipPublicFolderInitialization specifica se ignorare la creazione immediata delle cartelle pubbliche della Rubrica offline se si sta creando una rubrica offline che usa la distribuzione di cartelle pubbliche. Con questa opzione non è necessario specificare alcun valore.

La rubrica offline non è disponibile per il download fino al completamento del ciclo di manutenzione della cartella del sito successivo. L'omissione di questa opzione potrebbe causare la sospensione dell'attività mentre contatta il server di cartelle pubbliche responsabile per creare le cartelle pubbliche necessarie. Se il server non è attualmente raggiungibile o è altrimenti costoso da contattare, la sospensione potrebbe essere significativa.

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

-Versions

Applicabile: Exchange Server 2010

Questo parametro è disponibile solo in Exchange Server 2010.

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)

Proprietà dei parametri

Tipo:MultiValuedProperty
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

-VirtualDirectories

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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 è il servizio Accesso client (front-end) e le directory virtuali 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}). 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 il parametro GlobalWebDistributionEnabled su $true, perché i servizi Accesso client in qualsiasi server Cassette postali possono inviare le richieste di download della Rubrica offline in ingresso al percorso corretto.

Proprietà dei parametri

Tipo:

VirtualDirectoryIdParameter[]

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

-WhatIf

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.

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.

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.