Set-PublicFolder

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2012-03-26

Il cmdlet Set-PublicFolder consente di impostare gli attributi delle cartelle pubbliche.

Sintassi

Set-PublicFolder -Identity <PublicFolderIdParameter> [-AgeLimit <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IssueWarningQuota <Unlimited>] [-MaxItemSize <Unlimited>] [-Name <String>] [-PerUserReadStateEnabled <$true | $false>] [-ProhibitPostQuota <Unlimited>] [-Replicas <DatabaseIdParameter[]>] [-ReplicationSchedule <Schedule>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-Server <ServerIdParameter>] [-UseDatabaseAgeDefaults <$true | $false>] [-UseDatabaseQuotaDefaults <$true | $false>] [-UseDatabaseReplicationSchedule <$true | $false>] [-UseDatabaseRetentionDefaults <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-PublicFolder -Identity <PublicFolderIdParameter> [-AgeLimit <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IssueWarningQuota <Unlimited>] [-LocalReplicaAgeLimit <EnhancedTimeSpan>] [-MaxItemSize <Unlimited>] [-Name <String>] [-PerUserReadStateEnabled <$true | $false>] [-ProhibitPostQuota <Unlimited>] [-Replicas <DatabaseIdParameter[]>] [-ReplicationSchedule <Schedule>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-Server <ServerIdParameter>] [-UseDatabaseAgeDefaults <$true | $false>] [-UseDatabaseQuotaDefaults <$true | $false>] [-UseDatabaseReplicationSchedule <$true | $false>] [-UseDatabaseRetentionDefaults <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-PublicFolder [-AgeLimit <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HiddenFromAddressListsEnabled <$true | $false>] [-Instance <PublicFolder>] [-IssueWarningQuota <Unlimited>] [-MaxItemSize <Unlimited>] [-Name <String>] [-PerUserReadStateEnabled <$true | $false>] [-ProhibitPostQuota <Unlimited>] [-Replicas <DatabaseIdParameter[]>] [-ReplicationSchedule <Schedule>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-Server <ServerIdParameter>] [-UseDatabaseAgeDefaults <$true | $false>] [-UseDatabaseQuotaDefaults <$true | $false>] [-UseDatabaseReplicationSchedule <$true | $false>] [-UseDatabaseRetentionDefaults <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Per eseguire il cmdlet Set-PublicFolder, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo amministratore cartelle pubbliche di Exchange e gruppo Administrators locale del server di destinazione

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter

Il parametro Identity consente di specificare il GUID o il nome della cartella pubblica che rappresenta una cartella pubblica specifica. È inoltre possibile includere il percorso utilizzando il formato TopLevelPublicFolder\PublicFolder.

È possibile omettere l'etichetta del parametro Identity affinché venga fornito solo il nome della cartella pubblica o il GUID.

AgeLimit

Facoltativo

Microsoft.Exchange.Data.EnhancedTimeSpan

Il parametro AgeLimit consente di specificare il limite complessivo di validità sulla cartella. Le repliche di questa cartella pubblica saranno eliminate automaticamente una volta superato il periodo di validità. Questo e il parametro UseDatabaseAgeDefaults si escludono reciprocamente.

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro Confirm consente di determinare la sospensione dell'elaborazione e di richiedere che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con il parametro Confirm non è necessario specificare un valore.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Il parametro DomainController consente di specificare il controller di dominio da utilizzare per scrivere le modifiche di configurazione in Active Directory. Utilizzare il nome di dominio completo del controller di dominio che si desidera utilizzare.

HiddenFromAddressListsEnabled

Facoltativo

System.Boolean

Il parametro HiddenFromAddressListsEnabled consente di specificare se nascondere la cartella pubblica dall'elenco di indirizzi.

Instance

Facoltativo

Microsoft.Exchange.Data.Mapi.PublicFolder

Il parametro Instance consente di passare l'intero oggetto al comando per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare l'intero oggetto al comando.

IssueWarningQuota

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro IssueWarningQuota consente di specificare la dimensione delle cartelle pubbliche raggiunta la quale ai relativi proprietari viene inviata una notifica per informarli che la cartella è quasi piena.

LocalReplicaAgeLimit

Facoltativo

Microsoft.Exchange.Data.EnhancedTimeSpan

Il parametro LocalReplicaAgeLimit consente di specificare il limite di validità della replica, se disponibile, sul server connesso. Per rimuovere il limite di validità, impostare il valore del parametro su "$null".

MaxItemSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro MaxItemSize consente di specificare la dimensione massima di un elemento in kilobyte (KB) che può essere inserita. Questo e il parametro UseDatabaseQuotaDefaults si escludono reciprocamente.

Name

Facoltativo

System.String

Il parametro Name consente di specificare il nome della cartella pubblica.

PerUserReadStateEnabled

Facoltativo

System.Boolean

Il parametro PerUserReadStateEnabled consente di specificare di conservare i dati letti e non letti per utente.

ProhibitPostQuota

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro ProhibitPostQuota consente di specificare la dimensione di una cartella pubblica raggiunta la quale agli utenti viene inviata una notifica per informarli che la cartella pubblica è piena. Gli utenti non possono inserire alcun elemento in una cartella di dimensioni superiori al valore indicato nel parametro ProhibitPostQuota.

Replicas

Facoltativo

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter[]

Il parametro Replicas consente di specificare un elenco di server Cassette postali con il quale replicare questa cartella pubblica.

ReplicationSchedule

Facoltativo

Microsoft.Exchange.Data.Schedule

Il parametro ReplicationSchedule consente di specificare la pianificazione della replica per la cartella nel seguente formato:

Giorno.Ora:Minuto [AM/PM]-Giorno.Ora:Minuto [AM/PM].

Il nome del giorno può essere intero o abbreviato. Se si preferisce utilizzare il formato 24 ore, omettere la dicitura AM/PM. È possibile utilizzare formati misti.

Esempio: Dom.1:15 AM-Lunedì.23:00

Questo e il parametro UseDatabaseReplicationSchedule si escludono reciprocamente.

RetainDeletedItemsFor

Facoltativo

Microsoft.Exchange.Data.EnhancedTimeSpan

Il parametro RetainDeletedItemsFor consente di specificare il periodo di mantenimento per gli elementi eliminati. Questo e il parametro UseDatabaseRetentionDefaults si escludono reciprocamente.

Server

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Il parametro Server consente di specificare il server sul quale eseguire le operazioni selezionate.

UseDatabaseAgeDefaults

Facoltativo

System.Boolean

Il parametro UseDatabaseAgeDefaults consente di specificare l'utilizzo del limite di validità del database.

UseDatabaseQuotaDefaults

Facoltativo

System.Boolean

Il parametro UseDatabaseQuotaDefaults consente di specificare l'utilizzo dei limiti di quota per l'archiviazione di cartelle pubbliche.

UseDatabaseReplicationSchedule

Facoltativo

System.Boolean

Il parametro UseDatabaseReplicationSchedule consente di specificare la pianificazione della replica di cartelle pubbliche.

UseDatabaseRetentionDefaults

Facoltativo

System.Boolean

Il parametro UseDatabaseRetentionDefaults consente di specificare l'utilizzo delle impostazioni predefinite per il mantenimento del database.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente di indicare al comando di simulare le azioni da eseguire sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

  

Eccezioni

Eccezioni Descrizione

  

Esempio

Nel primo esempio il comando Set-PublicFolder consente di modificare una cartella pubblica in modo che essa non utilizzi la pianificazione della replica predefinita del database.

Nel secondo esempio il comando Set-PublicFolder viene utilizzato per impostare la pianificazione della replica su Sempre.

Nel terzo esempio il comando Set-PublicFolder viene utilizzato per impostare la replica della cartella solo durante il fine settimana.

Set-PublicFolder "\Customer Service Requests" -UseDatabaseReplicationSchedule $false
Set-PublicFolder "\Customer Service Requests" -ReplicationSchedule Always
Set-PublicFolder \MyPublicFolder -ReplicationSchedule "Saturday.12:00 AM-Monday.12:00 AM"

Tutti i parametri del comando Set-PublicFolder supportano immissioni in pipeline del relativo argomento e tipo forte.

Quando si imposta il parametro UseDatabaseQuotaDefaults su true, vengono ripristinati i seguenti valori predefiniti:

  • MaxItemSize

  • IssueWarningQuota

  • ProhibitPostQuota

Non è possibile utilizzare il cmdlet Set-PublicFolder per modificare i seguenti valori quando il parametro UseDatabaseQuotaDefaults è impostato su true:

  • MaxItemSize

  • IssueWarningQuota

  • ProhibitPostQuota

Ciò è dovuto al fatto che questi valori non sono applicabili quando si utilizzano le quote di database predefinite.

In Exchange Server 2007 Service Pack 2 (SP2), il valore IssueWarningQuota deve essere inferiore o uguale al valore ProhibitPostQuota. Inoltre il valore MaxItemSize deve essere inferiore o uguale al valore ProhibitPostQuota.