Get-RDMAdministrativeRole

Übersicht

Die in der aktuellen Datenquelle verfügbaren administrativen Rollen abrufen.

Syntax

ID

Get-RDMAdministrativeRole [-ID] <guid> [-ScopeType <AdministrativeRoleAssignmentScopeType>]
 [-ForcePromptAnswer <DialogResult[]>] [<CommonParameters>]

Name

Get-RDMAdministrativeRole [[-Name] <string>] [-ScopeType <AdministrativeRoleAssignmentScopeType>]
 [-CaseSensitive] [-ForcePromptAnswer <DialogResult[]>] [<CommonParameters>]

Beschreibung

Die administrativen Rollen abrufen, die in der aktuellen Datenquelle zugewiesen werden können, optional gefiltert nach Name, ID oder unterstütztem Bereichstyp. Das Cmdlet funktioniert mit Datenquellen, die den Zugriff über administrative Rollenzuweisungen verwalten (derzeit nur Devolutions Server).

Beispiele

Beispiel 1

PS C:\> Get-RDMAdministrativeRole

Ruft jede in der Datenquelle verfügbare administrative Rolle ab.

Beispiel 2

PS C:\> Get-RDMAdministrativeRole -ScopeType Repository

Ruft nur die Rollen ab, die einem Tresor zugewiesen werden können.

Beispiel 3

PS C:\> $role = Get-RDMAdministrativeRole -Name "Vault Owner"
PS C:\> $user = Get-RDMUser -Name "jsmith"
PS C:\> $user | Add-RDMRoleAssignment -RoleID $role.Id -ScopeType Repository -ScopeID $vault.ID

Löst eine Rolle nach Name auf und weist sie einem Benutzer für einen Tresor zu.

Parameter

-CaseSensitive

Groß-/kleinschreibungsabhängigen Namensabgleich verwenden

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Name
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ForcePromptAnswer

Mit Vorsicht zu verwendender Schalter. Er beantwortet automatisch Eingabeaufforderungen mit Ja/Nein-, Ja/Nein/Abbrechen- oder OK/Abbrechen-Fragen. Bei mehreren Eingabeaufforderungen können mehrere Werte an diesen Parameter übergeben werden. Hier sind die zulässigen Werte:

• Yes: Die Eingabeaufforderung annehmen. Deckt die Werte OK und Automatic ab.
• No: Die Ja/Nein/Abbrechen-Eingabeaufforderung ablehnen. "Cancel" ist die Ausweichoption, wenn keine "No"-Option vorhanden ist.
• Cancel: Die Ja/Nein/Abbrechen-Eingabeaufforderung abbrechen. "No" ist die Ausweichoption, wenn keine "Cancel"-Option vorhanden ist.

Type: System.Windows.Forms.DialogResult[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ID

Abzurufende ID der administrativen Rolle

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ID
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Name

Nach Rollenname filtern (unterstützt Platzhalter)

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Name
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ScopeType

Nur die Rollen zurückgeben, die diesem Bereichstyp zugewiesen werden können

Type: System.Nullable`1[Devolutions.RemoteDesktopManager.AdministrativeRoleAssignmentScopeType]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

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

Ausgaben

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSAdministrativeRole

Hinweise

Weitere Informationen erhalten Sie mit "Get-Help Get-RDMAdministrativeRole -detailed". Technische Informationen erhalten Sie mit "Get-Help Get-RDMAdministrativeRole -full".