중앙 집중식 배포 PowerShell cmdlet을 사용하여 추가 기능 관리

아티클
04/04/2024

Microsoft 365 사용자 관리자는 중앙 집중식 배포 기능을 통해 사용자에게 Office 추가 기능을 배포할 수 있습니다( 관리 센터에서 Office 추가 기능 배포 참조). Microsoft 365 관리 센터를 통해 Office 추가 기능을 배포하는 것 외에도 Microsoft PowerShell을 사용할 수도 있습니다. Windows PowerShell용 O365 중앙 집중식 Add-In 배포 모듈을 설치합니다.

모듈을 다운로드한 후 일반 Windows PowerShell 창을 열고 다음 cmdlet을 실행합니다.

 Import-Module -Name O365CentralizedAddInDeployment

관리자 자격 증명을 사용하여 연결

중앙 집중식 배포 cmdlet을 사용하려면 로그인해야 합니다.

PowerShell을 시작합니다.
사용자 관리자 자격 증명을 사용하여 PowerShell에 연결합니다. 다음 cmdlet을 실행합니다.

Connect-OrganizationAddInService

열리는 로그인 프롬프트에서 Microsoft 365 사용자 관리자 자격 증명을 선택하거나 입력합니다.

참고

PowerShell 사용에 대한 자세한 내용은 PowerShell을 사용하여 Microsoft 365에 연결을 참조하세요.

추가 기능 매니페스트 업로드

New-OrganizationAdd-In cmdlet을 실행하여 파일 위치 또는 URL일 수 있는 경로에서 추가 기능 매니페스트를 업로드합니다. 다음 예제에서는 ManifestPath 매개 변수의 값에 대한 파일 위치를 보여줍니다.

New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'

다음 예제와 같이 New-OrganizationAdd-In cmdlet을 실행하여 추가 기능을 업로드하고 Members 매개 변수를 사용하여 사용자 또는 그룹에 직접 할당할 수도 있습니다. 멤버의 이메일 주소를 쉼표로 구분합니다.

New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US' -Members  'KathyBonner@contoso.com', 'MaxHargrave@contoso.com'

Office 스토어에서 추가 기능 업로드

New-OrganizationAddIn cmdlet을 실행하여 Office 스토어에서 매니페스트를 업로드합니다.

다음 예제에서 New-OrganizationAddIn cmdlet 은 미국 위치 및 콘텐츠 시장의 추가 기능에 대한 AssetId를 지정합니다.

New-OrganizationAddIn -AssetId 'WA104099688' -Locale 'en-US' -ContentMarket 'en-US'

AssetId 매개 변수의 값을 확인하려면 추가 기능에 대한 Office Store 웹 페이지의 URL에서 복사할 수 있습니다. AssetIds는 항상 "WA"와 숫자로 시작합니다. 예를 들어 이전 예제에서 WA104099688 AssetId 값의 원본은 추가 기능에 대한 Office Store 웹 페이지 URL입니다 https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Locale 매개 변수 및 ContentMarket 매개 변수의 값은 동일하며 추가 기능을 설치하려는 국가/지역을 나타냅니다. 형식은 en-US, fr-FR 등입니다.

참고

Office 스토어에서 업로드된 추가 기능은 Office 스토어에서 사용할 수 있는 최신 업데이트의 며칠 이내에 자동으로 업데이트됩니다.

추가 기능의 세부 정보 가져오기

아래와 같이 Get-OrganizationAddIn cmdlet 을 실행하여 테넌트로 업로드된 모든 추가 기능에 대한 세부 정보를 가져오고 추가 기능의 제품 ID를 포함합니다.

Get-OrganizationAddIn

ProductId 매개 변수 값으로 Get-OrganizationAddIn cmdlet을 실행하여 세부 정보를 검색할 추가 기능을 지정합니다.

Get-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122

모든 추가 기능과 할당된 사용자 및 그룹의 전체 세부 정보를 얻으려면 다음 예제와 같이 Get-OrganizationAddIn cmdlet 의 출력을 Format-List cmdlet으로 파이프합니다.

foreach($G in (Get-organizationAddIn)){Get-OrganizationAddIn -ProductId $G.ProductId | Format-List}

추가 기능 켜기 또는 끄기

추가 기능을 해제하여 할당된 사용자 및 그룹이 더 이상 액세스할 수 없도록 하려면 다음 예제와 같이 ProductId 매개 변수 및 Enabled 매개 변수를 로 설정하여 $falseSet-OrganizationAddIn cmdlet을 실행합니다.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $false

추가 기능을 다시 켜려면 Enabled 매개 변수가 로 설정된 동일한 cmdlet을 실행합니다 $true.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $true

추가 기능에서 사용자 추가 또는 제거

특정 추가 기능에 사용자 및 그룹을 추가하려면 ProductId, Add 및 Members 매개 변수를 사용하여 Set-OrganizationAddInAssignments cmdlet을 실행합니다. 멤버의 이메일 주소를 쉼표로 구분합니다.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Add -Members 'KathyBonner@contoso.com','sales@contoso.com'

사용자 및 그룹을 제거하려면 Remove 매개 변수를 사용하여 동일한 cmdlet을 실행합니다.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Remove -Members 'KathyBonner@contoso.com','sales@contoso.com'

테넌트에서 모든 사용자에게 추가 기능을 할당하려면 값이 로 설정된 AssignToEveryone 매개 변수를 사용하여 동일한 cmdlet을 실행합니다 $true.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $true

모든 사용자에게 추가 기능을 할당하지 않고 이전에 할당된 사용자 및 그룹으로 되돌리려면 동일한 cmdlet을 실행하고 값을 로 설정하여 AssignToEveryone 매개 변수를 해제할 $false수 있습니다.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $false

추가 기능 업데이트

매니페스트에서 추가 기능을 업데이트하려면 다음 예제와 같이 ProductId, ManifestPath 및 Locale 매개 변수를 사용하여 Set-OrganizationAddIn cmdlet을 실행합니다.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'

참고

Office 스토어에서 업로드된 추가 기능은 Office 스토어에서 사용할 수 있는 최신 업데이트의 며칠 이내에 자동으로 업데이트됩니다.

추가 기능 삭제

추가 기능을 삭제하려면 다음 예제와 같이 ProductId 매개 변수를 사용하여 Remove-OrganizationAddIn cmdlet을 실행합니다.

Remove-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122

각 cmdlet에 대한 자세한 도움말 보기

Get-help cmdlet을 사용하여 각 cmdlet에 대한 자세한 도움말을 볼 수 있습니다. 예를 들어 다음 cmdlet은 Remove-OrganizationAddIn cmdlet에 대한 자세한 정보를 제공합니다.

Get-help Remove-OrganizationAddIn -Full

다음을 통해 공유