New-OfflineAddressBook
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Usare il cmdlet New-OfflineAddressBook per creare rubriche offline.
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
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. 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
$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 $trueIn 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 questo esempio crea la rubrica offline nuova 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,Version2In Exchange Server 2010 questo esempio crea la rubrica offline legacy della Rubrica offline 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, verrà restituito un errore. Per altre informazioni, vedere Gestione delle cartelle pubbliche.
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: | True |
| 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 |
-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 |
-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. 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PublicFolderDatabase
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.
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-PublicFolderDistributionEnabled
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.
| 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 è 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"
| Type: | Schedule |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Server
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
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-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 |
-SkipPublicFolderInitialization
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-Versions
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)
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-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 è 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.
| 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 |
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.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per