Set-AmsActiveDirectoryJitGroupCreationRule

SYNOPSIS

Sets one or more properties of an excisting just-in-time Active Directory group creation rule

SYNTAX

Set-AmsActiveDirectoryJitGroupCreationRule -Id <String> [-ComputerOU <String>] [-CreateUnixGid <Boolean>]
 [-EnableJitGroupDeletion <Boolean>] [-GroupDescription <String>] [-GroupNameTemplate <String>]
 [-GroupOU <String>] [-GroupType <ActiveDirectoryGroupType>] [-PreferredDC <String>] [-Subtree <Boolean>]
 [-UnixGidAttributeName <String>] [-UnixGidStartRange <Int32>] [<CommonParameters>]

DESCRIPTION

This cmdlet sets one or more properties of an existing just-in-time Active Directory group creation rule

EXAMPLES

Example 1

PS C:\> Set-AmsActiveDirectoryJitGroupCreationRule -Id "12345678-1234-1234-1234-123456789012" -CreateUnixGid $true -UnixGidAttributeName "gidNumber" -UnixGidStartRange 10000	 -EnableJitGroupDeletion $true	-GroupDescription "AMS JIT Group" -GroupNameTemplate "JIT-%ComputerName%" -GroupOU "OU=Groups,DC=lithnet,DC=local" -ComputerOU "OU=Computers,DC=lithnet,DC=local" -Subtree $true

Sets the properties of the JIT group creation rule with the specified ID

PARAMETERS

-ComputerOU

The OU that will be used to searched for computer objects

Type: String
Parameter Sets: (All)
Aliases:

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

-CreateUnixGid

Specifies if AMS should create a unique unix GID for the group

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableJitGroupDeletion

Specifies if AMS should delete the group when the computer is removed from the directory

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-GroupDescription

The description of the rule

Type: String
Parameter Sets: (All)
Aliases:

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

-GroupNameTemplate

The template used to create the group name

Type: String
Parameter Sets: (All)
Aliases:

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

-GroupOU

The OU that the groups will be created in

Type: String
Parameter Sets: (All)
Aliases:

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

-GroupType

The type of AD group to create

Type: ActiveDirectoryGroupType
Parameter Sets: (All)
Aliases:

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

-Id

The ID of the rule

Type: String
Parameter Sets: (All)
Aliases:

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

-PreferredDC

The preferred domain controller to use when creating groups. Leave blank to automatically choose a domain controller

Type: String
Parameter Sets: (All)
Aliases:

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

-Subtree

Specifies if AMS should search child organizational units of the 'ComputerOU' for computer objects

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UnixGidAttributeName

The name of the LDAP attribute to populate with the group's unique unix GID

Type: String
Parameter Sets: (All)
Aliases:

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

-UnixGidStartRange

The starting range of unix GIDs to use

Type: Int32
Parameter Sets: (All)
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

Lithnet.AccessManager.PowerShell.JitConfigurationOptionsPSObject

NOTES

RELATED LINKS