Share via

Update-SCOMRunAsAccount

  • Referenz
Modul:
OperationsManager

Updates die Anmeldeinformationen eines ausführend ausgeführten Operations Manager-Kontos.

Syntax

Update-SCOMRunAsAccount
      [-WindowsAccount] <WindowsCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-BasicAccount] <BasicCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-SimpleAccount] <SimpleCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-DigestAccount] <DigestCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-ActionAccount] <ActionAccountSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-CommunityStringAccount] <CommunityStringSecureData>
      [-CommunityString] <SecureString>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-BinaryAccount] <GenericSecureData>
      [-Path] <String>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Update-SCOMRunAsAccount aktualisiert die Anmeldeinformationen eines ausführenden System Center - Operations Manager-Kontos. Mit einem ausführenden Konto können Benutzer nach Bedarf die erforderlichen Berechtigungen für die Verwendung mit Regeln, Aufgaben, Monitoren und Ermittlungen angeben, die auf bestimmte Computer ausgerichtet sind.

Dieses Cmdlet unterstützt keine SCX-Konten (plattformübergreifend) oder SNMPv3-Konten (Simple Network Management Protocol, Version 3). Verwenden Sie stattdessen Get-SCOMRunAsAccount, um SCX-Konten zu aktualisieren.

Beispiele

Beispiel 1: Aktualisieren eines ausgeführten Windows-Kontos

PS C:\>$WindowsAccount = Get-SCOMRunAsAccount -Name "Domain Admin"
PS C:\>$WindowsAccount | Update-SCOMRunAsAccount -RunAsCredential (Get-Credential)

In diesem Beispiel wird ein ausführenes Windows-Konto aktualisiert.

Mit dem ersten Befehl wird das Ausführen des Kontoobjekts mit dem Namen Domain Admin abgerufen und das Objekt in der variablen $WindowsAccount gespeichert.

Der zweite Befehl übergibt das ausführende Konto, das in der variablen $WindowsAccount gespeichert ist, mithilfe des Pipelineoperators an das Cmdlet Update-SCOMRunAsAccount . Dieses Cmdlet aktualisiert die Anmeldeinformationen für das Konto auf den Benutzernamen und das Kennwort, die der Benutzer bereitstellt, indem er auf die Eingabeaufforderung des Cmdlets Get-Credential reagiert.

Beispiel 2: Aktualisieren einer Aktion Ausführen eines Kontos

PS C:\>$UserName = "Contoso\SCOMActionAccount"
PS C:\>$Password = Read-Host -AsSecureString
PS C:\>$NewCred = new-object System.Management.Automation.PsCredential $UserName,$Password
PS C:\>Get-SCOMRunAsAccount -Name "SCOM Action Account" | Update-SCOMRunAsAccount -RunAsCredential $newCred

In diesem Beispiel werden die Anmeldeinformationen für ein ausführenes Konto der Aktion aktualisiert.

Der erste Befehl erstellt eine Zeichenfolge, die einen Aktionskontonamen enthält, und speichert die Zeichenfolge in der variablen $UserName.

Mit dem zweiten Befehl wird der Benutzer aufgefordert, eine Zeichenfolge einzugeben, die das Kennwort darstellt. Anschließend wird die Benutzereingabe als sichere Zeichenfolge in der variablen $Password gespeichert.

Der dritte Befehl erstellt ein PSCredential-Objekt unter Verwendung des in der variablen $UserName gespeicherten Namens und des in $Password gespeicherten Kennworts. Anschließend wird das PSCredential-Objekt in der variablen $NewCred gespeichert.

Mit dem letzten Befehl wird das Aktionskonto SCOM-Aktionskonto abgerufen. Anschließend wird der Pipelineoperator verwendet, um das Konto an das Cmdlet Update-SCOMRunAsAccount zu übergeben, das das Konto mit den anmeldeinformationen aktualisiert, die in der variablen $NewCred gespeichert sind.

Beispiel 3: Aktualisieren eines Communityzeichenfolgenkontos

PS C:\>Get-SCOMRunAsAccount -Name "MyCommunityStringAccount" | Update-SCOMRunAsAccount -CommunityString (Read-Host -AsSecureString)

Dieser Befehl aktualisiert die Anmeldeinformationen für ein ausführenes Konto, das die Communityzeichenfolgenauthentifizierung für SNMP Version 2 verwendet. Es ruft das Communityzeichenfolgenkonto mit dem Namen MyCommunityStringAccount ab und verwendet den Pipelineoperator, um das Konto an das Cmdlet Update-SCOMRunAsAccount zu übergeben. Dieses Cmdlet aktualisiert die Communityzeichenfolge mit dem Wert, den der Benutzer als Reaktion auf Aufforderungen des Cmdlets Read-Host eingibt. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Read-Host.

Beispiel 4: Aktualisieren eines Kontos für die binäre Authentifizierung

PS C:\>Get-SCOMRunAsAccount -Name "MyBinaryAccount" | Update-SCOMRunAsAccount -Path ".\data.txt"

In diesem Beispiel wird das binäre Kontoobjekt MyBinaryAccount abgerufen und der Pipelineoperator verwendet, um das Objekt an das Cmdlet Update-SCOMRunAsAccount zu übergeben. Dieses Cmdlet verwendet den Parameter Path , um anzugeben, dass die neuen Kontodaten aus der Datei mit dem Namen data.txt abgerufen werden.

Parameter

-AccountType

Gibt den Typ des ausführend-Kontos an. Die Pipeline füllt diesen Wert in der Regel automatisch auf.

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

-ActionAccount

Gibt ein Aktionskonto als ausführenes Konto an.

Type:ActionAccountSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-BasicAccount

Gibt ein ausführenes Konto an, das die Standardauthentifizierung verwendet.

Type:BasicCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-BinaryAccount

Gibt ein ausführenes Konto an, das die binäre Authentifizierung verwendet.

Type:GenericSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CommunityString

Gibt die neue Communityzeichenfolge für ein ausführenes SNMP-Konto der Version 2 an, das die Communityzeichenfolgenauthentifizierung verwendet.

Type:SecureString
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CommunityStringAccount

Gibt ein ausführenes SNMP Version 2-Konto an, das die Communityzeichenfolgenauthentifizierung verwendet.

Type:CommunityStringSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet stellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer her. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers den Computernamen, localhost oder einen Punkt (.) ein.

Der System Center Data Access-Dienst muss auf dem Computer gestartet werden. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.

Type:String[]
Position:Named
Default value:None
Required:False
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

-Credential

Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Geben Sie für diesen Parameter ein PSCredential-Objekt an, z. B. eines, das das Cmdlet Get-Credential zurückgibt. Um weitere Informationen zu Anmeldeinformationsobjekten zu erhalten, geben Sie ein Get-Help Get-Credential.

Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.

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

-DigestAccount

Gibt ein ausführenes Konto an, das die Standard-Digest-Webauthentifizierung verwendet.

Type:DigestCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
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

-Path

Gibt den Pfad zu einer Datei an, die neue Anmeldeinformationen für ausführende Konten enthält, die binäre Authentifizierung verwenden.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RunAsCredential

Gibt neue Anmeldeinformationen für Kontotypen an, die einen Benutzernamen und ein Kennwort verwenden.

Type:PSCredential
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

Gibt ein Array von Connection-Objekten an. Verwenden Sie zum Abrufen von Verbindungsobjekten das Cmdlet Get-SCOMManagementGroupConnection .

Wenn dieser Parameter nicht angegeben wird, verwendet das Cmdlet die aktive persistente Verbindung mit einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , um eine andere persistente Verbindung anzugeben. Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe erstellen, indem Sie die Parameter ComputerName und Credential verwenden. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SimpleAccount

Gibt ein ausführenes Konto an, das die einfache Webauthentifizierung verwendet.

Type:SimpleCredentialSecureData
Position:1
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

-WindowsAccount

Gibt ein ausführenes Konto an, das Windows-Authentifizierung verwendet.

Type:WindowsCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False