Freigeben über

New-AzureADMSRoleDefinition

Modul:
AzureAD Module

Erstellt eine Azure AD-Rollendefinition.

Syntax

Default (Standardwert) 

New-AzureADMSRoleDefinition
    [-Description <String>]
    -DisplayName <String>
    [-ResourceScopes <System.Collections.Generic.List`1[System.String]>]
    -IsEnabled <Boolean>
    -RolePermissions <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.RolePermission]>
    [-TemplateId <String>]
    [-Version <String>]
    [<CommonParameters>]

Beschreibung

Mit dem Cmdlet New-AzureADMSRoleDefinition wird eine Azure Active Directory-Rollendefinition (Azure AD) erstellt.

Beispiele

Beispiel 1

PS C:\>
$allowedResourceAction = @()
$allowedResourceAction += @("microsoft.directory/applications/create")
$rolePermission = @{'allowedResourceActions' = $allowedResourceAction}
$rolePermissions = @()
$rolePermissions += $rolePermission

$resourceScopes = @()
$resourceScopes += '/'

New-AzureADMSRoleDefinition -RolePermissions $rolePermissions -IsEnabled $true -DisplayName 'MyRoleDefinition' -ResourceScopes $resourceScopes

Id              : c466024e-f757-4409-a897-d780916814b1
OdataType       :
Description     :
DisplayName     : fgdf
IsBuiltIn       : False
ResourceScopes  : {/}
IsEnabled       : True
RolePermissions : {class RolePermission {
                  AllowedResourceActions:
                  microsoft.directory/applications/create
                    Condition:
                  }
                  }
TemplateId      : f2ef992c-3afb-46b9-b7cf-a126ee74c451
Version         :

Mit diesem Befehl wird eine neue Rollendefinition in Azure AD erstellt.

Parameter

-Description

Gibt eine Beschreibung für die Rollendefinition an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisplayName

Gibt einen Anzeigenamen für die Rollendefinition an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IsEnabled

Gibt an, ob die Rollendefinition aktiviert ist.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceScopes

Gibt die Ressourcenbereiche für die Rollendefinition an.

Parametereigenschaften

Typ:

List<T>[String]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RolePermissions

Gibt Berechtigungen für die Rollendefinition an.

Parametereigenschaften

Typ:

List<T>[Microsoft.Open.MSGraph.Model.RolePermission]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TemplateId

Gibt die Vorlagen-ID für die Rollendefinition an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Version

Gibt die Version für die Rollendefinition an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

Microsoft.Open.MSGraph.Model.DirectoryRoleDefinition

Hinweise

Weitere Informationen finden Sie im Migrationsleitfaden für New-AzureADMSRoleDefinition zu Microsoft Graph PowerShell.