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>] [[-SecureContentExport] <ControlStatus>]
[[-ContentCopying] <ControlStatus>] [-Force] [<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 Coi1 -AttributeIssuer CP -AttributeName DuplicateName -AttributeValue DuplicateValue -ForegroundColor '#000000' -BackgroundColor '#ffffff' -Force $true
Creates a duplicate security context using the force flag.
EXAMPLE 3
New-MceSecurityContext displayName attributeIssuer attributeName attributeValue foreground background encryptionKeyExpirationHours
Creates a security context with an encryption key expiration time.
EXAMPLE 4
$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 5
$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 6
New-MceSecurityContext -DisplayName Coi1 -AttributeIssuer CP -AttributeName cois -AttributeValue COI1 -ForegroundColor '#000000' -BackgroundColor '#ffffff' -IsEncryptionEnabled $true
Creates a security context with enabled encryption.
EXAMPLE 7
New-MceSecurityContext -DisplayName Coi1 -AttributeIssuer CP -AttributeName cois -AttributeValue COI1 -ForegroundColor '#000000' -BackgroundColor '#ffffff' -SecureContentExport 'Enabled' -ContentCopying 'Disabled'
Creates a security context with secure content export enabled and disabled 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
-SecureContentExport
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.
Possible values: Inherited, Enabled, Disabled
Type: ControlStatus
Parameter Sets: (All)
Aliases:
Accepted values: Inherited, Enabled, Disabled
Required: False
Position: 8
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ContentCopying
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.
Possible values: Inherited, Enabled, Disabled
Type: ControlStatus
Parameter Sets: (All)
Aliases:
Accepted values: Inherited, Enabled, Disabled
Required: False
Position: 9
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force
The flag used to determine whether to add the security context regardless of existing duplicate security contexts.
This value is optional; running without this flag will cause the the command to fail if existing duplicate security contexts exist.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: 10
Default value: False
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.