New-MceSecurityContext

SYNOPSIS#

Creates a new security context.

SYNTAX#

New-MceSecurityContext [-DisplayName] <String> [-AttributeIssuer] <String> [-AttributeName] <String>
 [-AttributeValue] <String> [-ForegroundColor] <String> [-BackgroundColor] <String>
 [[-EncryptionKeyExpirationHours] <Int32>] [-EncryptionKeyExpirationMinutes <Int32>]
 [[-IsEncryptionEnabled] <Boolean>] [[-IsSecureContentExportEnabled] <Boolean>]
 [[-IsContentCopyingDisabled] <Boolean>] [<CommonParameters>]

DESCRIPTION#

This cmdlet creates a new security context on the system, and returns the security context's ID.

The cmdlet is designed to support pipelining from Microsoft.ActiveDirectory.Management.ADUser instances to create security contexts linked to Active Directory identities.

EXAMPLES#

EXAMPLE 1#

New-MceSecurityContext -DisplayName Coi1 -AttributeIssuer CP -AttributeName cois -AttributeValue COI1 -ForegroundColor '#000000' -BackgroundColor '#ffffff'

Creates a security context.

EXAMPLE 2#

New-MceSecurityContext displayName attributeIssuer attributeName attributeValue foreground background encryptionKeyExpirationHours

Creates a security context with an encryption key expiration time.

EXAMPLE 3#

$Guid = Get-AdGroup -Filter 'Name -Like "Users"'

New-MceSecurityContext -DisplayName "Users" -AttributeIssuer "AD" -AttributeName "http://schemas.mindlinksoft.com/identity/claims/group" -AttributeValue $Guid -ForegroundColor '#000000' -BackgroundColor '#ffffff'

Creates a security context for the Users group.

EXAMPLE 4#

$Guid = Get-AdOrganizationalUnit -Filter 'Name -Like "OU1"'

New-MceSecurityContext -DisplayName "Users" -AttributeIssuer "AD" -AttributeName "http://schemas.mindlinksoft.com/identity/claims/container" -AttributeValue $Guid -ForegroundColor '#000000' -BackgroundColor '#ffffff'

Creates a security context for the OU1 organizational unit.

EXAMPLE 5#

New-MceSecurityContext -DisplayName Coi1 -AttributeIssuer CP -AttributeName cois -AttributeValue COI1 -ForegroundColor '#000000' -BackgroundColor '#ffffff' -IsEncryptionEnabled $true

Creates a security context with enabled encryption.

EXAMPLE 6#

New-MceSecurityContext -DisplayName Coi1 -AttributeIssuer CP -AttributeName cois -AttributeValue COI1 -ForegroundColor '#000000' -BackgroundColor '#ffffff' -IsSecureContentExportEnabled $False -IsContentCopyingDisabled $False

Creates a security context with secure content export disabled and enabled content copying.

PARAMETERS#

-DisplayName#

The user display name.

Type: String
Parameter Sets: (All)
Aliases:

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

-AttributeIssuer#

The attribute issuer.

Type: String
Parameter Sets: (All)
Aliases:

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

-AttributeName#

The attribute name.

Type: String
Parameter Sets: (All)
Aliases:

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

-AttributeValue#

The attribute name.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForegroundColor#

The foreground color.

Type: String
Parameter Sets: (All)
Aliases:

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

-BackgroundColor#

The background color.

Type: String
Parameter Sets: (All)
Aliases:

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

-EncryptionKeyExpirationHours#

The key expiration interval.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-EncryptionKeyExpirationMinutes#

The key expiration interval.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-IsEncryptionEnabled#

A value indicating whether encryption is enabled for the security context. The system can be configured such that when this value is true, all groups that use this security context must be encrypted.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-IsSecureContentExportEnabled#

A value indicating whether secure content export is enabled for the security context. The system can be configured such that when this value is true, all groups that use this security context will allow for the conversation history to be exported securely.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-IsContentCopyingDisabled#

A value indicating whether whether content copying is disabled for the security context. The system can be configured such that when this value is true, all groups that use this security context will prevent users from copying messages.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: 9
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.