Condividi tramite

Update-SCOMRunAsAccount

  • Riferimento
Modulo:
OperationsManager

Aggiorna le credenziali di un account RunAs di Operations Manager.

Sintassi

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>]

Descrizione

Il cmdlet Update-SCOMRunAsAccount aggiorna le credenziali di un account RunAs di System Center Operations Manager. Un account RunAs consente agli utenti di specificare le autorizzazioni necessarie per l'uso con regole, attività, monitoraggi e individuazioni destinate a computer specifici in base alle esigenze.

Questo cmdlet non supporta account SCX (multipiattaforma) o account Simple Network Management Protocol versione 3 (SNMPv3). Usare invece Get-SCOMRunAsAccount per aggiornare gli account SCX.

Esempio

Esempio 1: Aggiornare un account RunAs di Windows

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

Questo esempio aggiorna un account RunAs di Windows.

Il primo comando ottiene l'oggetto account RunAs denominato Domain Admin e archivia l'oggetto nella variabile $WindowsAccount.

Il secondo comando passa l'account RunAs archiviato nella variabile $WindowsAccount alla cmdlet Update-SCOMRunAsAccount usando l'operatore pipeline. Questo cmdlet aggiorna le credenziali per l'account al nome utente e alla password forniti dall'utente rispondendo alla richiesta dal cmdlet get-Credential .

Esempio 2: Aggiornare un'azione Account RunAs

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

Questo esempio aggiorna le credenziali per un account RunAs azione.

Il primo comando crea una stringa contenente un nome dell'account azione e archivia la stringa nella variabile $UserName.

Il secondo comando richiede all'utente di immettere una stringa che rappresenta la password. Archivia quindi l'input dell'utente come stringa sicura nella variabile $Password.

Il terzo comando crea un oggetto PSCredential usando il nome archiviato nella variabile $UserName e la password archiviata in $Password. Archivia quindi l'oggetto PSCredential nella variabile $NewCred.

L'ultimo comando ottiene l'account azione denominato Account azione SCOM. Usa quindi l'operatore pipeline per passare l'account al cmdlet Update-SCOMRunAsAccount update-SCOMRunAsAccount, che aggiorna l'account con le credenziali archiviate nella variabile $NewCred.

Esempio 3: Aggiornare un account stringa della community

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

Questo comando aggiorna le credenziali per un account RunAs che usa l'autenticazione della stringa della community per SNMP versione 2. Ottiene l'account stringa della community denominato MyCommunityStringAccount e usa l'operatore pipeline per passare l'account al cmdlet Update-SCOMRunAsAccount . Questo cmdlet aggiorna la stringa della community con il valore immesso dall'utente in risposta alle richieste del cmdlet Read-Host . Per altre informazioni, digitare Get-Help Read-Host.

Esempio 4: Aggiornare un account di autenticazione binaria

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

Questo esempio ottiene l'oggetto account binario denominato MyBinaryAccount e usa l'operatore pipeline per passare l'oggetto al cmdlet Update-SCOMRunAsAccount. Questo cmdlet usa il parametro Path per indicare che ottiene i nuovi dati dell'account dal file denominato data.txt.

Parametri

-AccountType

Specifica il tipo di account RunAs. La pipeline popola in genere questo valore automaticamente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ActionAccount

Specifica un account azione come account RunAs.

Tipo:ActionAccountSecureData
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-BasicAccount

Specifica un account RunAs che usa l'autenticazione di base.

Tipo:BasicCredentialSecureData
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-BinaryAccount

Specifica un account RunAs che usa l'autenticazione binaria.

Tipo:GenericSecureData
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-CommunityString

Specifica la nuova stringa della community per un account RunAs SNMP versione 2 che usa l'autenticazione della stringa della community.

Tipo:SecureString
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CommunityStringAccount

Specifica un account RunAs SNMP versione 2 che usa l'autenticazione della stringa della community.

Tipo:CommunityStringSecureData
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ComputerName

Specifica una matrice di nomi di computer. Il cmdlet stabilisce connessioni temporanee con i gruppi di gestione per questi computer. È possibile usare nomi NetBIOS, indirizzi IP o nomi di dominio completi (FQDN). Per specificare il computer locale, digitare il nome del computer, localhost o un punto (.).

Il servizio di accesso ai dati di System Center deve essere avviato nel computer. Se non si specifica un computer, il cmdlet usa il computer per la connessione al gruppo di gestione corrente.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Specifica l'account utente in cui viene eseguita la connessione al gruppo di gestione. Specificare un oggetto PSCredential , ad esempio quello restituito dal cmdlet get-Credential per questo parametro. Per altre informazioni sugli oggetti credenziali, digitare Get-Help Get-Credential.

Se si specifica un computer nel parametro ComputerName, utilizzare un account che abbia accesso a tale computer. Il valore predefinito è l'utente corrente.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DigestAccount

Specifica un account RunAs che usa l'autenticazione Web digest standard.

Tipo:DigestCredentialSecureData
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Indica che il cmdlet crea o modifica un oggetto che un comando può usare nella pipeline. Per impostazione predefinita, questo cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Specifica il percorso di un file che contiene nuovi dati delle credenziali per gli account RunAs che usano l'autenticazione binaria.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsCredential

Specifica le nuove credenziali per i tipi di account che usano un nome utente e una password.

Tipo:PSCredential
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SCSession

Specifica una matrice di oggetti Connection. Per ottenere oggetti Connection, usare il cmdlet Get-SCOMManagementGroupConnection .

Se questo parametro non viene specificato, il cmdlet usa la connessione permanente attiva a un gruppo di gestione. Usare il parametro SCSession per specificare una connessione permanente diversa. È possibile creare una connessione temporanea a un gruppo di gestione usando i parametri ComputerName e credenziali. Per altre informazioni, digitare Get-Help about_OpsMgr_Connections.

Tipo:Connection[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SimpleAccount

Specifica un account RunAs che usa l'autenticazione Web semplice.

Tipo:SimpleCredentialSecureData
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WindowsAccount

Specifica un account RunAs che usa l'autenticazione di Windows.

Tipo:WindowsCredentialSecureData
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False