Freigeben über


Set-SCOMRunAsProfile

Fügt "Als Konten ausführen" hinzu, oder entfernt sie aus einem Run As-Profil.

Syntax

Set-SCOMRunAsProfile
   [-Account] <SecureData[]>
   [-Profile] <ManagementPackSecureReference>
   [-Action] <RunAsProfileAccountsAction>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMRunAsProfile
   [-Class] <ManagementPackClass[]>
   [-Account] <SecureData[]>
   [-Profile] <ManagementPackSecureReference>
   [-Action] <RunAsProfileAccountsAction>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMRunAsProfile
   [-Instance] <MonitoringObject[]>
   [-Account] <SecureData[]>
   [-Profile] <ManagementPackSecureReference>
   [-Action] <RunAsProfileAccountsAction>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMRunAsProfile
   [-Group] <MonitoringObject[]>
   [-Account] <SecureData[]>
   [-Profile] <ManagementPackSecureReference>
   [-Action] <RunAsProfileAccountsAction>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-SCOMRunAsProfile fügt Run As-Konten hinzu oder entfernt Run As-Konten aus einem Run As-Profil.

Beispiele

Beispiel 1: Hinzufügen eines Run As-Kontos zu einem Run As-Profil durch Angeben eines Kontonamens

PS C:\>$Profile = Get-RunAsProfile -DisplayName "Privileged Monitoring Account"
PS C:\> $Account = Get-SCOMRunAsAccount -Name "High Privileged Account"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account

In diesem Beispiel wird ein Run As-Konto zu einem Run As-Profil hinzugefügt, indem ein Kontoname angegeben wird.

Der erste Befehl ruft das Profil "Ausführen als" mit dem Anzeigenamen "Privileged Monitoring Account" ab und speichert ihn in der variablen $Profile.

Der zweite Befehl ruft das "Als Konto ausführen" mit dem Namen "High Privileged Account" ab und speichert es in der $Account Variablen.

Der dritte Befehl fügt das Konto, das in der variablen $Account gespeichert ist, dem in der variablen $Profile gespeicherten Run As-Profil hinzu und konfiguriert das Run As-Konto. Da der Befehl keine Klasse, Eine Gruppe oder ein Objekt angibt, konfiguriert er das Run As-Konto, um alle zielbezogenen Objekte zu verwalten.

Beispiel 2: Hinzufügen eines Run As-Kontos zu einem Run As-Profil durch Angeben eines Pfads

PS C:\>$Profile = Get-SCOMRunAsProfile -DisplayName "SQL Server Monitoring Account"
PS C:\> $Account = Get-SCOMrunAsAccount -Name "Contoso\SQLAuth"
PS C:\> $Group = Get-SCOMGroup -DisplayName "Contoso financial SQL Servers"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account -Group $Group

In diesem Beispiel wird einem Run As-Profil ein Run As-Konto hinzugefügt, indem ein Pfadname angegeben wird.

Der erste Befehl ruft das "Als Profil ausführen" mit dem Namen "SQL Server Überwachungskonto" ab und speichert ihn in der $Profile Variablen.

Der zweite Befehl ruft das Run As-Konto "Contoso\SQLAuth" ab und speichert ihn in der variablen $Account.

Der dritte Befehl ruft die Gruppe namens Contoso financial SQL Servers ab und speichert sie in der $Group Variablen.

Der vierte Befehl fügt das Konto, das in der $Account Variablen gespeichert ist, dem in der $Profile Variablen gespeicherten Run As-Profil hinzu und konfiguriert das Ausführen als Konto, um die gruppe zu verwalten, die in der $Group Variablen gespeichert ist.

Beispiel 3: Hinzufügen eines Run As-Kontos zu einem Run As-Profil durch Angeben eines Objekts

PS C:\>$Profile = Get-SCOMRunAsProfile -DisplayName "SQL Server Monitoring Account"
PS C:\> $Account = Get-SCOMrunAsAccount -Name "Contoso\SQLAuth"
PS C:\> $Group = Get-SCOMGroup -DisplayName "Contoso financial SQL Servers"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account -Group $Group

In diesem Beispiel wird ein Run As-Konto zu einem Run As-Profil hinzugefügt, indem ein Kontoobjekt angegeben wird.

Der erste Befehl ruft das Run As-Profilobjekt ab, das den Anzeigenamen SQL Server Überwachungskonto enthält und das Objekt in der $Profile Variablen speichert.

Der zweite Befehl ruft das Run As-Kontoobjekt "Contoso\SQLAuth" ab und speichert das Objekt in der $Account Variablen.

Der dritte Befehl ruft das Gruppenobjekt ab, das den Anzeigenamen Contoso financial SQL Servers aufweist und das Objekt in der $Group Variablen speichert.

Der letzte Befehl fügt das konto und die Gruppe hinzu, das in $Account gespeichert ist, und $Group dem Profil SQL Server Überwachungskonto, das in der $Profile Variablen gespeichert ist.

Parameter

-Account

Gibt ein Array von Microsoft.EnterpriseManagement.Security.SecureData-Objekten an, die Run As-Konten darstellen. Verwenden Sie zum Abrufen eines SecureData-Objekts das Cmdlet Get-SCOMRunAsAccount .

Type:SecureData[]
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Action

Gibt die Auszuführende Aktion an, um das Profil "Ausführen als" zu aktualisieren. Die zulässigen Werte für diesen Parameter sind: Hinzufügen oder Entfernen.

Type:RunAsProfileAccountsAction
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Class

Gibt ein Array von ManagementPackClass-Objekten an, die die Klassen darstellen, die das Run As-Konto verwalten kann. Geben Sie eine Variable an, die Klassen speichert, oder verwenden Sie ein Cmdlet wie Get-SCOMClass , das Klassen abruft.

Type:ManagementPackClass[]
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Group

Gibt ein Array von Überwachungsobjekten an, die die Gruppen darstellen, die das Run As-Konto verwalten kann. Geben Sie eine Variable an, die Gruppen speichert, oder verwenden Sie ein Cmdlet wie Get-SCOMGroup , das Gruppen abruft.

Type:MonitoringObject[]
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Instance

Gibt ein Array von Überwachungsobjekten an, die die Klasseninstanzen darstellen, die das Run As-Konto verwalten kann. Geben Sie eine Variable an, die Klasseninstanzen speichert oder ein Cmdlet wie Get-SCOMClassInstance verwendet, das Klasseninstanzen abruft. Dieser Parameter akzeptiert auch Gruppenobjekte. Verwenden Sie zum Abrufen eines Gruppenobjekts das Cmdlet Get-SCOMGroup .

Type:MonitoringObject[]
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Gibt an, dass das Cmdlet ein Objekt erstellt oder ändert, das ein Befehl in der Pipeline verwenden kann. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Gibt das zu aktualisierende Run As-Profil an. Geben Sie eine Variable an, die ein Run As-Profil speichert, oder verwenden Sie ein Cmdlet wie Get-SCOMRunAsProfile , das ein Profil abruft.

Type:ManagementPackSecureReference
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False