New-AzManagedServicesDefinition

登録定義を作成または更新します。

構文

New-AzManagedServicesDefinition
   -Name <String>
   [-Scope <String>]
   [-Authorization <IAuthorization[]>]
   [-Description <String>]
   [-EligibleAuthorization <IEligibleAuthorization[]>]
   [-ManagedByTenantId <String>]
   [-PlanName <String>]
   [-PlanProduct <String>]
   [-PlanPublisher <String>]
   [-PlanVersion <String>]
   [-RegistrationDefinitionName <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

登録定義を作成または更新します。

例 1: 永続的な承認を使用して新しい Azure Lighthouse 登録定義オブジェクトを作成する

$permantAuth = New-AzManagedServicesAuthorizationObject -PrincipalId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -RoleDefinitionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -PrincipalIdDisplayName "Test user" -DelegatedRoleDefinitionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

New-AzManagedServicesDefinition -Name xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -RegistrationDefinitionName "Test definition" -ManagedByTenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -Authorization $permantAuth -Description "Test definition desc" -Scope "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Name                                 Type
----                                 ----
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx Microsoft.ManagedServices/registrationDefinitions

永続的な承認を使用して、新しい Azure Lighthouse 登録定義オブジェクトを作成します。

例 2: 永続的な承認と適格な承認の両方を使用して、新しい Azure Lighthouse 登録定義オブジェクトを作成する

$approver = New-AzManagedServicesEligibleApproverObject -PrincipalId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -PrincipalIdDisplayName "Approver group"

$eligibleAuth = New-AzManagedServicesEligibleAuthorizationObject -PrincipalId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -PrincipalIdDisplayName "Test user" -RoleDefinitionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -JustInTimeAccessPolicyManagedByTenantApprover $approver -JustInTimeAccessPolicyMultiFactorAuthProvider Azure -JustInTimeAccessPolicyMaximumActivationDuration 0:30

New-AzManagedServicesDefinition -Name "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -RegistrationDefinitionName "Test definition" -ManagedByTenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -Authorization $permantAuth -EligibleAuthorization $eligibleAuth -Description "Test definition desc" -Scope "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Name                                 Type
----                                 ----
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxMicrosoft.ManagedServices/registrationDefinitions

永続的な承認と適格な承認の両方を使用して、新しい Azure Lighthouse 登録定義オブジェクトを作成します。

パラメーター

-AsJob

コマンドをジョブとして実行する

型:SwitchParameter
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-Authorization

managedBy テナント内の Azure Active Directory プリンシパルへのアクセスを記述する承認オブジェクトのコレクションは、マネージド テナント内の委任されたリソースで受け取ります。 構築するには、AUTHORIZATION プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

型:IAuthorization[]
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。

型:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

登録定義の説明。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-EligibleAuthorization

managedBy テナント内の Azure Active Directory プリンシパルへの Just-In-Time アクセスを記述する対象となる承認オブジェクトのコレクションは、マネージド テナント内の委任されたリソースで受け取ります。 構築するには、ELIGIBLEAUTHORIZATION プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

型:IEligibleAuthorization[]
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagedByTenantId

managedBy テナントの識別子。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

登録定義の GUID。

型:String
Aliases:RegistrationDefinitionId
Position:Named
既定値:None
必須:True
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

コマンドを非同期的に実行する

型:SwitchParameter
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-PlanName

Azure Marketplace プラン名。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-PlanProduct

Azure Marketplace 製品コード。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-PlanPublisher

Azure Marketplace の発行元 ID。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-PlanVersion

Azure Marketplace プランのバージョン。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-RegistrationDefinitionName

登録定義の名前。

型:String
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

リソースのスコープ。

型:String
Position:Named
既定値:"subscriptions/" + (Get-AzContext).Subscription.Id
必須:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
Position:Named
既定値:None
必須:False
Accept pipeline input:False
Accept wildcard characters:False

出力

IRegistrationDefinition