New-MailboxFolder

Riferimento

Modulo:: ExchangePowerShell

Si applica a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Utilizzare il cmdlet New-MailboxFolder per creare cartelle nella propria cassetta postale. Gli amministratori non possono utilizzare questo cmdlet per creare cartelle in altre cassette postali (il cmdlet è disponibile soltanto dal ruolo utente MyBaseOptions).

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

Sintassi

New-MailboxFolder
   [-Name] <String>
   -Parent <MailboxFolderIdParameter>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Se non viene specificata alcuna cartella principale, il cmdlet crea una cartella di posta elettronica nella gerarchia della cartella radice della cassetta postale. Se la cassetta postale non viene specificata, il cmdlet crea la cartella nella cassetta postale dell'utente che in quel momento esegue l'attività. Quando viene eseguito, il cmdlet restituisce come output il nuovo nome e il percorso della cartella.

È 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-MailboxFolder -Parent :\Inbox -Name Personal

In questo esempio viene creata la cartella denominata Personal nella cartella Posta in arrivo della propria cassetta postale.

Esempio 2

New-MailboxFolder -Parent :\ -Name Personal

In questo esempio viene creata la cartella denominata Personal nella gerarchia di cartelle radice della propria cassetta postale.

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 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

-Name

Il parametro Name consente di specificare il nome della nuova cartella. Se il valore contiene degli 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

-Parent

Il parametro Parent consente di specificare dove creare la nuova cartella della cassetta postale. La sintassi è [MailboxID]:\[ParentFolder][\SubFolder].

È possibile eseguire questo cmdlet solo nella propria cassetta postale, quindi non è necessario (o non è possibile) specificare un MailboxID valore.

Per specificare la gerarchia di cartelle radice della propria cassetta postale, usare il valore :\.

Per il valore di MailboxID, è possibile usare qualsiasi valore che identifichi in modo univoco la cassetta postale. 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)

Se non si specifica la cartella padre, il comando crea la cartella nella gerarchia di cartelle radice della cassetta postale specificata.

I valori di esempio per questo parametro sono john@contoso.com:, John:\Inbox

Type:	MailboxFolderIdParameter
Position:	Named
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

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