New-AmsComputerAuthorizationRule
SYNOPSIS
Creates a new computer authorization rule
SYNTAX
Azure AD tenant target authorized by ACL
New-AmsComputerAuthorizationRule -AadTenantId <String> [-PrincipalsAllowedLaps <Object[]>]
[-PrincipalsDeniedLaps <Object[]>] [-PrincipalsAllowedLapsHistory <Object[]>]
[-PrincipalsDeniedLapsHistory <Object[]>] [-LapsMaximumAccessDuration <TimeSpan>] [-LapsAllowExtension]
[-Description <String>] [-RuleExpiryDate <DateTime>] [-Disabled] [-Notes <String>]
[-UserRequestReasonRequirement <AuditReasonFieldState>] [-NotificationChannelsSuccess <String[]>]
[-NotificationChannelsFailure <String[]>] [<CommonParameters>]Azure AD tenant target authorized by script
New-AmsComputerAuthorizationRule -AadTenantId <String> -AuthorizationScriptPath <String>
[-LapsMaximumAccessDuration <TimeSpan>] [-LapsAllowExtension] [-Description <String>]
[-RuleExpiryDate <DateTime>] [-Disabled] [-Notes <String>]
[-UserRequestReasonRequirement <AuditReasonFieldState>] [-NotificationChannelsSuccess <String[]>]
[-NotificationChannelsFailure <String[]>] [<CommonParameters>]Azure AD group target authorized by ACL
Azure AD group target authorized by script
Azure AD computer target authorized by ACL
Azure AD computer target authorized by script
AD computer target authorized by ACL
AD computer target authorized by script
AD group target authorized by ACL
AD group target authorized by script
AD container target authorized by ACL
AD container target authorized by script
AMS computer target authorized by ACL
AMS computer target authorized by script
AMS group target authorized by ACL
AMS group target authorized by script
DESCRIPTION
This cmdlet creates a new computer authorization rule.
EXAMPLES
Example 1
This example creates a new authorization rule, that allows all members of the DOMAIN\AuthorizedLapsReaders group to access the LAPS password for all devices in the AMS group named My devices, and expires the LAPS password after one hour.
Example 2
This example creates a new authorization rule, that allows all members of the DOMAIN\AuthorizedLapsReaders group to access the LAPS password for all devices in the specified Azure AD tenant, and specifies that the user must provide a reason when requesting access to the LAPS password
Example 3
This example creates a new authorization rule, that allows all members of the DOMAIN\AuthorizedLapsReaders group to access the LAPS password for all devices in the specified Active Directory OU. It also specifies the audit channels to notify on the event a user triggers this rule.
Example 4
This example creates a new authorization rule, that allows all members of the DOMAIN\FinaanceAdmins group to JIT into the servers contained within the FinanceServers group. The rule is set to expire on 1st March 2025
PARAMETERS
-AadComputerId
The object ID of an Azure AD computer
-AadGroupId
The object ID of an Azure AD group
-AadTenantId
The tenant ID of a registered Azure AD tenant
-AdComputer
The fully qualified name or SID of an Active Directory computer
-AdContainer
The DN of an Active Directory container object such as an organizational unit
-AdGroup
The fully qualified name or SID of an Active Directory group
-AmsComputerId
The object ID of an AMS-registered computer
-AmsGroupId
The SID of an AMS group
-AuthorizationScriptPath
The path to the authorization script to import
-Description
A description of the rule
-Disabled
Indicates if the rule should be disabled
-JitAllowExtension
Specifies if the user is allowed to extend their JIT access request before it expires
-JitGroupName
The name of the group that users will be added to when granted access to this role
-JitMaximumAccessDuration
The maximum amount of time the user can request access to this computer via JIT
-LapsAllowExtension
Specifies if the user is allowed to extend their LAPS access request before it expires
-LapsMaximumAccessDuration
The maximum amount of time the user can request access to this computer's LAPS password before it is changed
-Notes
A custom field to store notes
-NotificationChannelsFailure
A list of channel IDs or names that should be notified when a user is denied access by this rule
-NotificationChannelsSuccess
A list of channel IDs or names that should be notified when a user is granted access by this rule
-PrincipalsAllowedBitLocker
The list of principals who are allowed BitLocker access to this computer.
-PrincipalsAllowedJit
The list of principals who are allowed JIT access to this computer.
-PrincipalsAllowedLaps
The list of principals who are allowed LAPS access to this computer.
-PrincipalsAllowedLapsHistory
The list of principals who are allowed LAPS history access to this computer.
-PrincipalsDeniedBitLocker
The list of principals who are not allowed BitLocker access to this computer.
-PrincipalsDeniedJit
The list of principals who are not allowed JIT access to this computer.
-PrincipalsDeniedLaps
The list of principals who are not allowed LAPS access to this computer.
-PrincipalsDeniedLapsHistory
The list of principals who are not allowed LAPS history access to this computer.
-RuleExpiryDate
A date and time when this rule will expire, expressed in local time
-UserRequestReasonRequirement
Specifies if the user must provide a reason for the request, if they can optionally provide a reason, or are not prompted at all for a reason
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.ComputerAuthorizationRulePSObject
NOTES
Use of this cmdlet requires an Enterprise Edition license.
RELATED LINKS
Last updated
Was this helpful?