Import-GWSharedMailboxes

SYNOPSIS

Imports shared mailboxes into a GroupWise tenant.

SYNTAX

Help

Import-GWSharedMailboxes
  [-ShowPrereqs]
  [<CommonParameters>]

Action

Import-GWSharedMailboxes
  -ConfigNode <String>
  -Csv <String>
  [-TranslationCsv <String>]
  [-IgnoreErrors]
  [-SkipValidation]
  [-ValidateOnly]
  [<CommonParameters>]

DESCRIPTION

Use the Import-GWSharedMailboxes cmdlet to import shared mailboxes into a GroupWise tenant.

See the Notes section for cmdlet requirements.

EXAMPLES

Example 1: Validation only

Import-GWSharedMailboxes -ConfigNode Target -Csv 'shared_mailboxes.csv' -ValidateOnly

This example validates all data for the shared mailboxes in the shared_mailboxes.csv file but does not perform the operation. This is a recommended first step so any warnings can be addressed first.

Example 2: Basic import

Import-GWSharedMailboxes -ConfigNode Target -Csv 'shared_mailboxes.csv'

This example imports all shared mailboxes from the shared_mailboxes.csv file.

Example 3: Advanced import with translation

Import-GWSharedMailboxes -ConfigNode Target -Csv 'shared_mailboxes.csv' -TranslationCsv 'translations.csv'

This example imports all shared mailboxes from the shared_mailboxes.csv file. Data is translated according to the mappings provided in the translations.csv file.

PARAMETERS

-ConfigNode

The config.psd1 configuration node to use.

Type: String
Parameter Sets: Action
Aliases:
Accepted values: Source, Target

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Csv

The path to a CSV file containing objects to import. See the Notes section for the required format.

Type: String
Parameter Sets: Action
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IgnoreErrors

Validation errors stop execution prior to the import by default. Use -IgnoreErrors to proceed with error records omitted.

Note that global errors are not impacted by this option.

Type: SwitchParameter
Parameter Sets: Action
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ShowPrereqs

Prints the cmdlet prerequisites.

Type: SwitchParameter
Parameter Sets: Help
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SkipValidation

Skips the property validation stage of the import. Data supplied via the -Csv parameter will be used as-is, which may lead to runtime errors.

Type: SwitchParameter
Parameter Sets: Action
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TranslationCsv

The path to the CSV file containing translation mappings. The file must use SourceName;TargetName as the field identifiers.

Type: String
Parameter Sets: Action
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ValidateOnly

Validation and import are both performed by default. Use -ValidateOnly to perform the validation but skip the import.

It is recommended to run a -ValidateOnly pass first to identify potential issues prior to importing data. Note that records with validation errors will fail to import unless -IgnoreErrors is used, but records with validation warnings proceed without the data triggering the warning. A -ValidateOnly pass allows you to inspect these warnings before data is written and make any necessary changes.

Type: SwitchParameter
Parameter Sets: Action
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None

OUTPUTS

System.Void

NOTES

Required config.psd1 keys

These configuration keys are scoped to the Source or Target node in config.psd1.

GWRestServer: The FQDN or IP address of a server running the GroupWise Admin Service.
GWSoapServers: A hashtable of post office objects. Each key should be the post office identifier as it appears in the GroupWise system. For each key, define Host and Port sub-keys that define the FQDN or IP address and port number, respectively. For example: PO1 = @{ Host = '192.168.0.101'; Port = '7191' }.
GWTrustedAppName: The name of the GroupWise trusted app.
GWTrustedAppKey: The key associated with the GroupWise trusted app.

Optional config.psd1 keys