Sdílet prostřednictvím

Set-MsolServicePrincipal

  • Reference
Modul:
MSOnline

Aktualizuje instanční objekt v Microsoft Azure Active Directory.

Syntaxe

Set-MsolServicePrincipal
   [-ObjectId <Guid>]
   [-AppPrincipalId <Guid>]
   [-DisplayName <String>]
   [-ServicePrincipalNames <String[]>]
   [-AccountEnabled <Boolean>]
   [-Addresses <RedirectUri[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

Rutina Set-MsolServicePrincipal aktualizuje instanční objekt v Microsoft Azure Active Directory. Dá se použít k aktualizaci zobrazovaný název, povolení nebo zakázání instančního objektu, důvěryhodného pro delegování, hlavních názvů služby (SPN) nebo adres.

Příklady

Příklad 1: Změna vlastností instančního objektu

PS C:\> $AppId = (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").AppPrincipalId
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -DisplayName "My Super Application" -ServicePrincipalNames @("MyApp/myapp.com", "MyApp/mysuperapp.com")

Tento příkaz aktualizuje vlastnosti zadaného instančního objektu. V tomto příkladu určuje aktualizace zobrazovaný název a hlavní názvy služby (SPN). Tím se přepíšou všechna předchozí nastavení.

Příklad 2: Změna adres v instančním objektu

PS C:\> $a = @()
PS C:\> $a = $a + (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").Addresses
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp1.com")
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp2.com")
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -Addresses $a

Tento příkaz aktualizuje adresy instančního objektu. V tomto příkladu jsou stávající adresy, které byly dříve vytvořeny ("myApp1.com", "myApp2.com") pomocí rutiny New-MsolServicePrincipalAddresses , přidruženy k instančnímu objektu.

Parametry

-AccountEnabled

Tato vlastnost je vyhrazena pro budoucí použití.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Addresses

Určuje seznam adres, pomocí kterého chcete aktualizovat a přepsat existující seznam. Pokud tento parametr nezadáte, existující vlastnost se neaktualizuje. Pokud zadáte prázdný seznam, stávající adresy se vymažou. K vytvoření objektu seznamu Adres použijte rutinu New-MsolServicePrincipalAddress .

Typ:RedirectUri[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-AppPrincipalId

Určuje jedinečné ID aplikace přidružené k instančnímu objektu, který se má aktualizovat.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DisplayName

Určuje zobrazovaný název instančního objektu.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ObjectId

Určuje jedinečné ID objektu instančního objektu, který se má aktualizovat.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ServicePrincipalNames

Určuje seznam hlavních názvů služby (SPN), pomocí kterých chcete aktualizovat a přepsat existující. Pokud tento parametr nezadáte, existující vlastnost se neaktualizuje. Pokud zadáte prázdný seznam, stávající hlavní názvy služby (SPN) se vymažou s výjimkou hlavního názvu služby( SPN), který obsahuje hodnotu AppId instančního objektu. Hlavní název služby (SPN) musí používat jeden z následujících formátů:

  • appName
  • appName/hostname
  • platná adresa URL
Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-TenantId

Určuje jedinečné ID tenanta, na kterém se má operace provést. Výchozí hodnota je tenant aktuálního uživatele. Tento parametr platí jenom pro uživatele partnerů.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False