Set-MailboxCalendarFolder

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

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 Set-MailboxCalendarFolder per configurare le impostazioni di pubblicazione o condivisione del calendario su una cassetta postale; in questo modo, le informazioni sul calendario sono visibili agli utenti esterni. Per aggiungere o modificare le autorizzazioni e consentire agli utenti interni di accedere al calendario, usare il cmdlet Add-MailboxFolderPermission o Set-MailboxFolderPermission.

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

Sintassi

Set-MailboxCalendarFolder
   [-Identity] <MailboxFolderIdParameter>
   [-Confirm]
   [-DetailLevel <DetailLevelEnumType>]
   [-DomainController <Fqdn>]
   [-PublishDateRangeFrom <DateRangeEnumType>]
   [-PublishDateRangeTo <DateRangeEnumType>]
   [-PublishEnabled <Boolean>]
   [-ResetUrl]
   [-SearchableUrlEnabled <Boolean>]
   [-SetAsSharingSource]
   [-SharedCalendarSyncStartDate <DateTime>]
   [-UseHttps]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-MailboxCalendarFolder configura le informazioni di pubblicazione del calendario. La cartella di calendario può essere configurata nel modo seguente:

  • Se la cartella di calendario è attivata per la pubblicazione
  • Intervallo di inizio e di fine giorni di calendario per la pubblicazione
  • Livello di dettaglio per la pubblicazione per il calendario
  • Se l'URL di pubblicazione del calendario è abilitato per la ricerca sul Web

È 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-MailboxCalendarFolder -Identity kai:\Calendar -DetailLevel LimitedDetails

In questo esempio viene impostato il livello di dettagli per la pubblicazione del calendario condiviso di Kai su LimitedDetails, ovvero solo pochi dettagli vengono visualizzati.

Esempio 2

Set-MailboxCalendarFolder -Identity kai:\Calendar -SearchableUrlEnabled $true

In questo esempio il calendario nella cassetta postale di Kai viene abilitato per le ricerche sul Web.

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, Exchange Online Protection

-DetailLevel

Il parametro DetailLevel consente di specificare il livello di dettaglio del calendario pubblicato e disponibile agli utenti anonimi. I valori validi sono:

  • AvailabilityOnly (questo è il valore predefinito)
  • LimitedDetails
  • FullDetails
  • Editor

Questo parametro è significativo solo quando il valore del parametro PublishEnabled è $true.

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

-Identity

Il parametro Identity consente di specificare la cartella del calendario da modificare. La sintassi è MailboxID:\ParentFolder[\SubFolder].

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)

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

Type:MailboxFolderIdParameter
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, Exchange Online Protection

-PublishDateRangeFrom

Il parametro PublishDateRangeFrom specifica la data di inizio delle informazioni del calendario da pubblicare (informazioni precedenti). I valori validi sono:

  • OneDay
  • Tre giorni
  • OneWeek
  • OneMonth
  • ThreeMonths (valore predefinito)
  • SixMonths
  • OneYear

Questo parametro è significativo solo quando il valore del parametro PublishEnabled è $true.

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

-PublishDateRangeTo

Il parametro PublishDateRangeTo consente di specificare la data di fine delle informazioni del calendario da pubblicare (informazioni future). I valori validi sono:

  • OneDay
  • Tre giorni
  • OneWeek
  • OneMonth
  • ThreeMonths (valore predefinito)
  • SixMonths
  • OneYear

Questo parametro è significativo solo quando il valore del parametro PublishEnabled è $true.

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

-PublishEnabled

Il parametro PublishEnabled consente di specificare se pubblicare le informazioni di calendario specificate. I valori validi sono:

  • $true: le informazioni sul calendario vengono pubblicate.
  • $false: le informazioni sul calendario non vengono pubblicate. 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

-ResetUrl

L'opzione ResetUrl sostituisce l'URL non pubblico esistente con un nuovo URL per un calendario pubblicato senza essere ricercabile pubblicamente. Con questa opzione non è necessario specificare alcun valore.

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

-SearchableUrlEnabled

Il parametro SearchableUrlEnabled consente di specificare se l'URL del calendario pubblicato è individuabile sul Web.

  • $true: l'URL del calendario pubblicato è individuabile sul Web.
  • $false: l'URL del calendario pubblicato non è individuabile sul Web. Questo è il valore predefinito.

Questo parametro è significativo solo quando il valore del parametro PublishEnabled è $true.

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

-SetAsSharingSource

L'opzione SetAsSharingSource specifica se impostare la cartella del calendario come origine di condivisione. Con questa opzione non è necessario specificare alcun valore.

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

-SharedCalendarSyncStartDate

Questo parametro è disponibile solamente nel servizio basato su cloud.

Nota: questo parametro è supportato solo per i calendari condivisi aggiornati come descritto in Condivisione del calendario in Microsoft 365 e non è applicabile ad altri tipi di cartella calendario o cassetta postale.

Il parametro SharedCalendarSyncStartDate consente di specificare il limite per gli eventi passati nel calendario condiviso visibili ai delegati. Una copia del calendario condiviso all'interno dell'intervallo di date specificato viene archiviata nella cassetta postale del delegato.

Per specificare un valore data/ora per questo parametro, utilizzare una delle opzioni seguenti:

  • Specificare il valore di data/ora in formato UTC: ad esempio, "2021-05-06 14:30:00z".
  • Specificare il valore di data/ora come formula che converte la data/ora nel fuso orario locale in formato UTC: ad esempio, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Per altre informazioni, vedere Get-Date.

Note:

  • Questo parametro viene usato nel calendario condiviso nella cassetta postale del delegato. Ad esempio, Set-MailboxCalendarFolder -Identity delegate@contoso.onmicrosoft.com:DelegateSharedCalendarFolderId" -SharedCalendarSyncStartDate (Get-Date "5/6/2023 9:30 AM").ToUniversalTime(). DelegateSharedCalendarFolderId è il FolderId del calendario condiviso nella cassetta postale del delegato (ad esempio, Get-MailboxFolderStatistics -Identity delegate@contoso.onmicrosoft.com -FolderScope Calendar | Format-List Name,FolderId).
  • Gli utenti devono avere accesso FullDetails, Editor o Delegate al calendario condiviso specificato.
  • Se si imposta questo parametro, gli eventi nel calendario condiviso potrebbero scomparire brevemente dalla visualizzazione mentre il calendario viene risincronizzato.
  • Il valore di questo parametro viene usato durante l'inizializzazione della sincronizzazione della cartella del calendario. Successivamente, ogni elemento nuovo, aggiornato ed eliminato viene elaborato e sincronizzato, indipendentemente dal valore del parametro SharedCalendarSyncStartDate.
Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UseHttps

L'opzione UseHttps specifica se usare HTTPS per l'URL pubblicato della cartella del calendario. Con questa opzione non è necessario specificare alcun valore.

Questa opzione è significativa solo quando viene $true il valore del parametro PublishEnabled.

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

-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, Exchange Online Protection

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.