你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzRoleAssignmentScheduleRequest

模块:: Az.Resources Module

创建角色分配计划请求。

语法

CreateExpanded (默认值)

New-AzRoleAssignmentScheduleRequest
    -Name <String>
    -Scope <String>
    [-Condition <String>]
    [-ConditionVersion <String>]
    [-ExpirationDuration <String>]
    [-ExpirationEndDateTime <DateTime>]
    [-ExpirationType <String>]
    [-Justification <String>]
    [-LinkedRoleEligibilityScheduleId <String>]
    [-PrincipalId <String>]
    [-RequestType <String>]
    [-RoleDefinitionId <String>]
    [-ScheduleInfoStartDateTime <DateTime>]
    [-TargetRoleAssignmentScheduleId <String>]
    [-TargetRoleAssignmentScheduleInstanceId <String>]
    [-TicketNumber <String>]
    [-TicketSystem <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath

New-AzRoleAssignmentScheduleRequest
    -Name <String>
    -Scope <String>
    -JsonFilePath <String>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzRoleAssignmentScheduleRequest
    -Name <String>
    -Scope <String>
    -JsonString <String>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

创建角色分配计划请求。

示例

示例 1：以管理员身份创建新的角色分配计划请求

$guid = "12f8978c-5d8d-4fbf-b4b6-2f43eeb43eca"
$startTime = Get-Date -Format o
$scope = "/subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d/"
New-AzRoleAssignmentScheduleRequest -Name $guid -Scope $scope -ExpirationDuration PT1H -ExpirationType AfterDuration -PrincipalId 5a4bdd72-ab3e-4d8e-ab0f-8dd8917481a2 -RequestType AdminAssign -RoleDefinitionId subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d/providers/Microsoft.Authorization/roleDefinitions/acdd72a7-3385-48ef-bd42-f606fba81ae7 -ScheduleInfoStartDateTime $startTime

Name                                 Type                                                    Scope                                               RoleDefinitionId
----                                 ----                                                    -----                                               ----------------
12f8978c-5d8d-4fbf-b4b6-2f43eeb43eca Microsoft.Authorization/roleAssignmentScheduleRequests /subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d /subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d/providers/Microsoft.Authori…

创建一个请求，用于为指定的分配预配活动分配roleDefinitionscopeprincipal

示例 2：以管理员身份删除角色分配计划请求

$guid = "13f8978c-5d8d-4fbf-b4b6-2f43eeb43eca"
$startTime = Get-Date -Format o
$scope = "/subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d/"
New-AzRoleAssignmentScheduleRequest -Name $guid -Scope $scope -ExpirationDuration PT1H -ExpirationType AfterDuration -PrincipalId 5a4bdd72-ab3e-4d8e-ab0f-8dd8917481a2 -RequestType AdminRemove -RoleDefinitionId subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d/providers/Microsoft.Authorization/roleDefinitions/acdd72a7-3385-48ef-bd42-f606fba81ae7 -ScheduleInfoStartDateTime $startTime

Name                                 Type                                                    Scope                                               RoleDefinitionId
----                                 ----                                                    -----                                               ----------------
13f8978c-5d8d-4fbf-b4b6-2f43eeb43eca Microsoft.Authorization/roleAssignmentScheduleRequests /subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d /subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d/providers/Microsoft.Authori…

创建一个请求以删除针对指定项的活动分配roleDefinitionscopeprincipal

示例 3：以用户身份激活新的角色分配计划请求

$guid = "12f8978c-5d8d-4fbf-b4b6-2f43eeb43eca"
$startTime = Get-Date -Format o
$scope = "/subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d/"
New-AzRoleAssignmentScheduleRequest -Name $guid -Scope $scope -ExpirationDuration PT1H -ExpirationType AfterDuration -PrincipalId 5a4bdd72-ab3e-4d8e-ab0f-8dd8917481a2 -RequestType SelfActivate -RoleDefinitionId subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d/providers/Microsoft.Authorization/roleDefinitions/acdd72a7-3385-48ef-bd42-f606fba81ae7 -ScheduleInfoStartDateTime $startTime

Name                                 Type                                                    Scope                                               RoleDefinitionId
----                                 ----                                                    -----                                               ----------------
12f8978c-5d8d-4fbf-b4b6-2f43eeb43eca Microsoft.Authorization/roleAssignmentScheduleRequests /subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d /subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d/providers/Microsoft.Authori…

创建一个请求，以激活针对指定项的合格分配roleDefinitionscopeprincipal

示例 4：以用户身份停用角色分配计划请求

$guid = "12f8978c-5d8d-4fbf-b4b6-2f43eeb43eca"
$startTime = Get-Date -Format o
$scope = "/subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d/"
New-AzRoleAssignmentScheduleRequest -Name $guid -Scope $scope -ExpirationDuration PT1H -ExpirationType AfterDuration -PrincipalId 5a4bdd72-ab3e-4d8e-ab0f-8dd8917481a2 -RequestType SelfDeactivate -RoleDefinitionId subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d/providers/Microsoft.Authorization/roleDefinitions/acdd72a7-3385-48ef-bd42-f606fba81ae7 -ScheduleInfoStartDateTime $startTime

Name                                 Type                                                    Scope                                               RoleDefinitionId
----                                 ----                                                    -----                                               ----------------
12f8978c-5d8d-4fbf-b4b6-2f43eeb43eca Microsoft.Authorization/roleAssignmentScheduleRequests /subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d /subscriptions/38ab2ccc-3747-4567-b36b-9478f5602f0d/providers/Microsoft.Authori…

创建一个请求，以停用针对指定项的合格分配roleDefinitionscopeprincipal

参数

-Condition

角色分配的条件。这会限制可分配给的资源。例如：@Resource[Microsoft.Storage/storageAccounts/blobServices/containers：ContainerName] StringEqualsIgnoreCase “foo_storage_container”

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ConditionVersion

条件的版本。当前接受的值为“2.0”

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

DefaultProfile 参数不起作用。如果对其他订阅执行 cmdlet，请使用 SubscriptionId 参数。

参数属性

类型:	PSObject
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzureRMContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ExpirationDuration

TimeSpan 中角色分配计划的持续时间。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ExpirationEndDateTime

角色分配计划的结束日期时间。

参数属性

类型:	DateTime
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ExpirationType

角色分配计划过期的类型

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-JsonFilePath

提供给“创建”操作的 Json 文件的路径

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateViaJsonFilePath

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-JsonString

提供给“创建”操作的 Json 字符串

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateViaJsonString

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Justification

角色分配的理由

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-LinkedRoleEligibilityScheduleId

链接的角色资格计划 ID - 激活资格。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

要创建的角色分配的名称。它可以是任何有效的 GUID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	RoleAssignmentScheduleRequestName

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PrincipalId

主体 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RequestType

角色分配计划请求的类型。例如：SelfActivate、AdminAssign 等

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RoleDefinitionId

角色定义 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ScheduleInfoStartDateTime

角色分配计划的开始日期时间。

参数属性

类型:	DateTime
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Scope

要创建的角色分配计划请求的范围。范围可以是任何 REST 资源实例。例如，对订阅使用“/providers/Microsoft.Subscription/subscriptions/{subscription-id}/”，资源组的“/providers/Microsoft.Subscription/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}”，对于资源，“/providers/Microsoft.Subscription/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/{resource-provider}/{resource-type}/{resource-name}”。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-TargetRoleAssignmentScheduleId

正在更新的结果角色分配计划 ID 或角色分配计划 ID

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-TargetRoleAssignmentScheduleInstanceId

正在更新的角色分配计划实例 ID

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-TicketNumber

角色分配的票证编号

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-TicketSystem

角色分配的票证系统名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

输出

IRoleAssignmentScheduleRequest

反馈

此页面是否有帮助？

通过

New-AzRoleAssignmentScheduleRequest

语法

CreateExpanded (默认值)

CreateViaJsonFilePath

CreateViaJsonString

说明

示例

示例 1：以管理员身份创建新的角色分配计划请求

示例 2：以管理员身份删除角色分配计划请求

示例 3：以用户身份激活新的角色分配计划请求

示例 4：以用户身份停用角色分配计划请求

参数

-Condition

参数属性

参数集

-ConditionVersion

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-ExpirationDuration

参数属性

参数集

-ExpirationEndDateTime

参数属性

参数集

-ExpirationType

参数属性

参数集

-JsonFilePath

参数属性

参数集

-JsonString

参数属性

参数集

-Justification

参数属性

参数集

-LinkedRoleEligibilityScheduleId

参数属性

参数集

-Name

参数属性

参数集

-PrincipalId

参数属性

参数集

-RequestType

参数属性

参数集

-RoleDefinitionId

参数属性

参数集

-ScheduleInfoStartDateTime

参数属性

参数集

-Scope

参数属性

参数集

-TargetRoleAssignmentScheduleId

参数属性

参数集

-TargetRoleAssignmentScheduleInstanceId

参数属性

参数集

-TicketNumber

参数属性

参数集

-TicketSystem

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters