Set-MailboxCalendarFolder
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.
Use o cmdlet Set-MailboxCalendarFolder para configurar a publicação do calendário ou as configurações de compartilhamento de uma caixa de correio para a visibilidade das informações de calendário para usuários externos. Para adicionar ou modificar as permissões para que usuários internos possam acessar o calendário, use os cmdlets Add-MailboxFolderPermission ou Set-MailboxFolderPermission.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Set-MailboxCalendarFolder
[-Identity] <MailboxFolderIdParameter>
[-Confirm]
[-DetailLevel <DetailLevelEnumType>]
[-DomainController <Fqdn>]
[-PublishDateRangeFrom <DateRangeEnumType>]
[-PublishDateRangeTo <DateRangeEnumType>]
[-PublishEnabled <Boolean>]
[-ResetUrl]
[-SearchableUrlEnabled <Boolean>]
[-SetAsSharingSource]
[-SharedCalendarSyncStartDate <DateTime>]
[-UseHttps]
[-WhatIf]
[<CommonParameters>]
Description
O cmdlet Set-MailboxCalendarFolder configura as informações de publicação do calendário. A pasta do calendário pode ser configurada da seguinte forma:
- Se a pasta do calendário estiver habilitada para publicação
- Intervalo de dias do calendário inicial e final para publicação
- Nível de detalhes para publicação do calendário
- Se a URL publicada do calendário está habilitada para pesquisa na Web
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Set-MailboxCalendarFolder -Identity kai:\Calendar -DetailLevel LimitedDetails
Este exemplo define o nível de detalhes a serem publicados para o calendário compartilhado de Kai como LimitedDetails, o que significa a exibição dos detalhes limitados.
Exemplo 2
Set-MailboxCalendarFolder -Identity kai:\Calendar -SearchableUrlEnabled $true
Este exemplo habilita o calendário na caixa de correio de Kai a ser pesquisada na Web.
Parâmetros
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DetailLevel
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro DetailLevel especifica o nível de detalhes do calendário publicado e disponível para usuários anônimos. Os valores válidos são:
- DisponibilidadeOnly (predefinição)
- LimitedDetails
- FullDetails
Este parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
Propriedades do parâmetro
| Tipo: | DetailLevelEnumType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
O parâmetro Identidade especifica a pasta de calendário que pretende modificar. A sintaxe é MailboxID:\ParentFolder[\SubFolder].
Para o valor de MailboxID, pode utilizar qualquer valor que identifique exclusivamente a caixa de correio. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- Domínio\Nome de Utilizador
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Os valores de exemplo para este parâmetro são john@contoso.com:\Calendar ou John:\Calendar
Propriedades do parâmetro
| Tipo: | MailboxFolderIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-PublishDateRangeFrom
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro PublishDateRangeFrom especifica a data de início das informações do calendário a publicar (informações anteriores). Os valores válidos são:
- OneDay
- Três Dias
- OneWeek
- OneMonth
- ThreeMonths (valor predefinido)
- SixMonths
- Ano Único
Este parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
Propriedades do parâmetro
| Tipo: | DateRangeEnumType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PublishDateRangeTo
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro PublishDateRangeTo especifica a data de fim das informações do calendário a publicar (informações futuras). Os valores válidos são:
- OneDay
- Três Dias
- OneWeek
- OneMonth
- ThreeMonths (valor predefinido)
- SixMonths
- Ano Único
Este parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
Propriedades do parâmetro
| Tipo: | DateRangeEnumType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PublishEnabled
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro PublishEnabled especifica se pretende publicar as informações do calendário especificadas. Os valores válidos são:
- $true: as informações do calendário são publicadas.
- $false: as informações do calendário não são publicadas. Este valor é a predefinição.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ResetUrl
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O comutador ResetUrl substitui o URL não público existente por um novo URL para um calendário publicado sem ser pesquisável publicamente. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SearchableUrlEnabled
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro SearchableUrlEnabled especifica se o URL do calendário publicado é detetável na Web.
- $true: o URL do calendário publicado é detetável na Web.
- $false: o URL do calendário publicado não é detetável na Web. Este valor é a predefinição.
Este parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SetAsSharingSource
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O comutador SetAsSharingSource especifica se pretende definir a pasta do calendário como uma origem de partilha. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SharedCalendarSyncStartDate
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
Nota: este parâmetro é suportado apenas para calendários partilhados que foram atualizados conforme descrito em Partilha de calendários no Microsoft 365 e não é aplicável a qualquer outro tipo de pasta de calendário ou caixa de correio.
O parâmetro SharedCalendarSyncStartDate especifica o limite de eventos passados no calendário partilhado que estão visíveis para os delegados. Uma cópia do calendário partilhado dentro do intervalo de datas especificado é armazenada na caixa de correio do delegado.
Para especificar um valor de data/hora para este parâmetro, use uma das opções a seguir:
- Especifique o valor de data/hora em UTC: por exemplo, "2021-05-06 14:30:00z".
- Especifique o valor de data/hora como uma fórmula que converte a data/hora no fuso horário local para UTC: por exemplo,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para mais informações, consulte Get-Date.
Observações:
- Utilize este parâmetro no calendário partilhado na caixa de correio do delegado. Por exemplo,
Set-MailboxCalendarFolder -Identity delegate@contoso.onmicrosoft.com:DelegateSharedCalendarFolderId" -SharedCalendarSyncStartDate (Get-Date "5/6/2023 9:30 AM").ToUniversalTime(). DelegateSharedCalendarFolderId é o FolderId do calendário partilhado na caixa de correio do delegado (por exemplo,Get-MailboxFolderStatistics -Identity delegate@contoso.onmicrosoft.com -FolderScope Calendar | Format-List Name,FolderId). - Os utilizadores precisam de ter acesso FullDetails, Editor ou Delegado ao calendário partilhado especificado.
- Definir este parâmetro pode fazer com que os eventos no calendário partilhado desapareçam brevemente da vista enquanto o calendário é ressincronizado.
- O valor deste parâmetro é utilizado ao inicializar a sincronização da pasta de calendário. Depois disso, todos os itens novos, atualizados e eliminados são processados e sincronizados, independentemente do valor do parâmetro SharedCalendarSyncStartDate.
Propriedades do parâmetro
| Tipo: | DateTime |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UseHttps
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O comutador UseHttps especifica se deve utilizar HTTPS para o URL publicado da pasta do calendário. Não é preciso especificar um valor com essa opção.
Este parâmetro só é significativo quando o valor do parâmetro PublishEnabled é $true.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.